Skip to content

About

The better way to manage VRChat galleries.

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Latest commit

Β 

History

316 Commits

Folders and files

Repository files navigation

Logo

VRCGalleryManager

Modern, Cross-Platform VRChat Media & Profile Management Suite
Powered by .NET 9 MAUI & Blazor Hybrid for Windows and Android

Platform Framework Release

Key Features β€’ Metadata Engine β€’ Requirements β€’ Installation β€’ Build System β€’ Disclaimer

Settings Photos

🌟 What's New in v2.0

VRCGalleryManager v2.0 represents a complete architectural overhaul. Migrated from the original Windows Forms foundation to a cutting-edge .NET 9 MAUI Blazor Hybrid application, VRCGalleryManager is now a high-performance cross-platform desktop and mobile client with a modern hardware-accelerated UI, native OS integrations, enhanced security, and deep VRChat profile customization.


✨ Key Features

πŸ“± Cross-Platform Architecture (.NET 9 MAUI + Blazor)

  • Windows & Android Support: Runs seamlessly on Windows 10/11 desktop and Android mobile devices (native APK).
  • Responsive Modern UI: Sleek dark-mode interface built with CSS design tokens, custom SVG icons, smooth transitions, and custom scrollbars.
  • Android Immersive Experience: Edge-to-edge layout with full display cutout (notch) support, translucent system bars, and responsive navigation drawers.
  • Cross-Platform Image Engine: Powered by SixLabors ImageSharp 4.1.0 for high-performance cross-platform image processing without native GDI+ dependencies.
  • Touch & Desktop Optimized: Native mouse & keyboard controls on Windows with full touch UX and mobile-friendly gestures on Android.

🎨 VRChat Profile Customization & Dynamic Themes

  • VRChat Profile Theme Sync: Automatically extracts your active VRChat profile theme colors (accent, buttons, icons, subtexts) and applies them dynamically across the app, including custom TitleBar buttons, SVG icon filters, glow accents, and scrollbars.
  • Custom Windows TitleBar: Sleek, borderless window header with custom minimize, maximize, and close buttons integrated with your active profile theme.
  • Profile Backgrounds Catalog: Access and preview official VRChat profile background banners (Grid, Cascade, Bit Mountain, Approach, Planet Fall, Jungle, Light Streams, etc.).
  • Animated Profile Effects ❀️: Support for VRChat profile cosmetics and animated canvas effects (Aura, Fire, Orbit, Bounce, Rain, Laser, Confetti, and more).
  • Profile Details Card: View your profile bio, status, pronouns, trust rank, unlimited user badges, icon frames, and avatar pictures directly in-app.

πŸ–ΌοΈ Comprehensive VRChat Plus Media Management

  • Multi-Selection & Batch Operations: Select multiple items with click or intuitive mouse drag-to-select across all media pages (Gallery, Photos, Stickers, Emojis, Prints, Profile Icons).
  • Safe Batch Deletion: Bulk delete media assets with confirmation dialogs and real-time progress indicators. Local screenshots are safely moved to the Windows Recycle Bin (preventing accidental loss), while VRChat Plus cloud media is deleted asynchronously in the background.
  • Batch Selection Toolbar: Floating contextual toolbar displaying live selection counts, Select All, Deselect All, and quick dismissal (Esc key supported).
  • Stickers & Emojis: Create, upload, organize, and delete VRChat custom stickers and emojis.
  • Photos & Gallery: Browse, manage, and upload high-resolution screenshots to your VRChat Plus online gallery.
  • Smart Folder Browser: Folder picker with automatic VRChat Pictures directory detection, subfolder navigation, and real-time photo count badges and tooltips.
  • Cross-Category Upload Pipeline: Seamlessly upload local screenshots and Picflow assets into any VRChat Plus album (Gallery, Prints, Stickers, Emojis, Profile Icons).
  • Prints: View, manage, and upload VRChat Prints with custom notes and print details.
  • User Profile Icons: Crop, adjust, and upload user profile icons.
  • Drag & Drop & Clipboard Paste: Drag and drop images directly into the application window or paste directly from clipboard (Ctrl + V).
  • High-Performance Caching (MediaCacheService): Smart local memory and disk caching prevents redundant network queries and ensures instant thumbnail loading.

πŸ“Έ Real-Time Screenshot Popups (Windows)

  • Instant Screenshot Notifications: Unobtrusive desktop overlay bubbles appear in real time the moment a new screenshot is captured in VRChat.
  • Quick Action Controls: Expand directly into the full-screen Global Image Viewer, copy image to clipboard, upload straight to VRChat Plus, or dismiss.
  • Smart Stacking & Progress Timer: Clean vertical stacking with smooth animations, configurable auto-dismiss countdown bar, and non-blocking interaction.

πŸ” Immersive Global Image Viewer & Native Saving

  • Centralized Global Modal: Accessible everywhere across the app (Gallery, Picflow, Stickers, Emojis, Prints, Icons, Popups) with smooth playlist navigation and auto-close on page changes.
  • Full-Screen Zoom & Pan: High-performance photo modal with smooth zooming, panning, and keyboard/touch navigation.
  • Dual Interactive Panels:
    • Session Info Panel (Right): Detailed VRChat world information, world author, instance type/ID, present player rosters, resolution, and aspect ratio.
    • QR Code Links Panel (Left): Built-in QrCodeService automatically detects QR codes (Discord invites, world links, web URLs) with one-click copy and browser navigation.
    • Both panels feature independent toggle controls and persist display preferences across sessions.
  • Direct Download & Gallery Sync:
    • Windows: Native file save dialog to save photos anywhere on your system.
    • Android: Direct save to Pictures/VRCGalleryManager with automatic MediaStore scanner notification, making images immediately visible in your device's photo gallery without needing a file manager.
  • Quick Actions: Download images locally, copy image/link to the system clipboard, or upload directly to VRChat.
  • Standalone Real-Time Metadata Injection (Windows): Pure C# PNG iTXt injector that monitors live game sessions and automatically embeds world, instance, and player lists into newly taken screenshots without needing external tools.

βœ‚οΈ Integrated Image & Emoji Editors

  • Quality Scale & Size Preview: Real-time file size calculation and quality scaling slider before uploading to ensure images never exceed VRChat limits.
  • Refine Edge & Crop: Built-in canvas tools for cropping and refining edges.
  • Advanced Spritesheet Support: Direct spritesheet creation and editing with automatic grid layout derivation (2Γ—2, 3Γ—3, 4Γ—4, up to 8Γ—8) dynamically computed from frame count.
  • Live Spritesheet Animation & Preview: Real-time animation preview with configurable playback FPS, customizable frame limits, and an interactive frame-by-frame thumbnail strip.
  • GIF to Sprite Sheet Converter: Convert animated GIFs into VRChat-compatible sprite sheet animations with configurable FPS, frame selection, and timeline settings.
Image Editor Emoji Editor

🌐 Picflow - Global Explorer & Local Database

  • Worldwide Sticker Explorer: Browse stickers placed across VRChat worlds with lazy-loading.
  • Themed Category Filters: Filter smoothly between Stickers, Emojis, and Prints with dynamic active theme styling.
  • Live Animated Emojis: Spritesheet-based emojis animate smoothly directly within the Picflow discovery grid using hardware-accelerated CSS frame stepping.
  • Live Stream Mode (Windows): Monitor and inspect new stickers in real time from VRChat logs as players place them.
  • Local Database (PicflowDatabase): Persistent local storage to cache and quickly search through discovered stickers and prints with one-click cleanup.
  • Info Dialog & Direct Upload: Quick inspection modal with creator details, asset info, and one-click upload to your personal collection.

πŸ”’ Security & Connectivity

  • Internal High-Performance API Client: Custom-built, lightweight VRChat API client replacing external SDKs with clean JSON parsing and direct multi-part uploads.
  • Modern Secure Storage: Uses platform-native OS secure storage (Microsoft.Maui.Storage.SecureStorage) instead of plaintext config files.
  • Two-Factor Authentication (2FA): Full support for both Authenticator TOTP codes and Email verification (with resend code option).
  • Resilient Networking: Automated network retry and backoff policies powered by Polly.
  • Real-Time Network Monitor: Dedicated NetworkStatusService detecting offline state with auto-reconnect notifications.

βš™οΈ Desktop & Mobile Maintenance Tools

  • System Tray Integration (Windows): Minimize to tray (H.NotifyIcon.Maui) to keep the app running quietly in the background.
  • Windows Startup: Optional toggle to launch automatically with Windows (with silent background startup).
  • In-App Auto-Updater:
    • Windows: Built-in update manager with animated download progress bars.
    • Android: In-app APK updater that checks releases, downloads the new APK, and triggers the native package installer.
  • VRChat Logs Inspector (Windows): View VRChat log file counts and total disk usage, with one-click options to open the logs folder or clean up old logs.
  • VRChat Cache Cleaner: Monitor VRChat cache size and safely purge temporary files directly from the settings panel.
  • Legal Notice & Compliance: Built-in Terms of Service compliance and legal notice panel.

πŸ“· Standalone Screenshot Metadata Engine

VRCGalleryManager includes a powerful, zero-dependency PNG Metadata Engine that automatically captures and embeds rich session details directly into your local screenshots.

⚑ Automatic Real-Time Metadata Injection (Windows)

  • Live VRChat Log Monitoring (Windows): The built-in VRCLogWatcherService tracks your active world, instance ID, world author, and dynamic player joins/leaves in real time.
  • Pure C# iTXt Injection: When a new screenshot is saved to your VRChat Pictures directory, VRCGalleryManager can automatically inject a standardized iTXt Description chunk directly into the PNG file.
  • Atomic & Safe: Recalculates PNG CRC32 checksums on the fly and writes atomically via temporary files, guaranteeing zero image corruption.
  • Standalone Convenience: No need to keep external helper applications runningβ€”your photos are automatically tagged with world and player information right as you take them (can be toggled on/off in Settings).

πŸ” Lightning-Fast Metadata Extraction

  • Sub-Millisecond Parsing: High-performance reader (MetaDataImageReader) parses PNG iTXt text chunks directly from the file stream in milliseconds without buffering or decoding full high-resolution images into RAM.
  • Smart Fallback Scanner: Employs span-based memory pools (ArrayPool<byte>) to detect metadata structures in legacy, modified, or alternative screenshot formats.
  • Cross-Compatible: Fully interoperable with standard VRChat community metadata formats and official camera metadata.

πŸ“‹ Rich Inspector & In-App Viewer

When viewing photos in the Gallery, through screenshot popups, or in the immersive full-screen Image Viewer:

  • World & Instance Info: World name, world author, instance type/ID, with quick-copy actions and a direct button to launch or open the world on the VRChat website.
  • Players Roster: Searchable list of all players present in the instance when the photo was captured, with one-click navigation to their official VRChat web profiles.
  • Image Diagnostics: File format, exact resolution, aspect ratio badge (16:9, 21:9, etc.), file size, capture date & time, and file name.
  • Integrated QR Code Scanner: Built-in QrCodeService detects QR codes (Discord invites, world links, web URLs) inside screenshots and presents them for instant copying or browser launching.
Gallery Image Viewer

πŸ“‹ Requirements

VRChat Account

  • A VRChat Plus subscription is required to manage photo galleries, prints, and custom stickers through the VRChat API.

System Requirements

Platform Requirement
Windows Windows 10 (version 1809 / build 17763 or newer) or Windows 11 (64-bit)
Android Android 7.0 (Nougat, API 24) or newer
Webview Microsoft Edge WebView2 Runtime (included in Windows 10/11) / Android System WebView

πŸš€ Installation & Download

Download the latest release for your platform from the Releases Page:

Windows

  • Installer (Recommended): Download and run VRCGalleryManager_Setup.exe to install the app with desktop and Start Menu shortcuts.
  • Standalone / Portable: Extract the portable ZIP release (VRCGalleryManager_Portable.zip) and launch VRCGalleryManager.exe.

Android

  • Download the VRCGalleryManager.apk file to your Android device.
  • Open the file and allow installation from your browser/file manager when prompted.
  • Future updates can be checked and installed directly from within the app!

πŸ› οΈ Building from Source

VRCGalleryManager includes an automated build system located in the Builder/ directory for compiling Windows and Android binaries with one click.

Prerequisites

  1. .NET 9 SDK: Download .NET 9.0 SDK
  2. .NET MAUI Workloads:
    dotnet workload install maui
    # Or install specific target workloads:
    dotnet workload install maui-windows
    dotnet workload install maui-android
  3. NSIS (Optional): If you want to generate the Windows VRCGalleryManager_Setup.exe installer, install NSIS (Nullsoft Scriptable Install System).

Build Scripts

Simply execute the batch scripts located in the Builder/ folder:

  • Builder/Build_Windows_EXE.bat: Compiles a self-contained Windows executable and generates the NSIS setup installer.
  • Builder/Pack_Portable_ZIP.bat: Quickly packages the compiled Windows build into a portable ZIP package.
  • Builder/Build_Android_APK.bat: Compiles and packages the release Android APK (VRCGalleryManager.apk).
  • Builder/Build_All.bat: Builds both Windows and Android packages in sequence.

Artifacts will be placed in Builder/Output/:

  • Builder/Output/Windows/
  • Builder/Output/VRCGalleryManager_Portable.zip
  • Builder/Output/VRCGalleryManager_Setup.exe
  • Builder/Output/VRCGalleryManager.apk

πŸ“œ Disclaimer & Terms of Service

VRCGalleryManager is an independent third-party tool that communicates exclusively through VRChat's official API endpoints. It does not modify, hook into, or alter the VRChat client or game files in any manner.

VRCGalleryManager is not affiliated with, sponsored by, or endorsed by VRChat Inc. VRChat and related marks are trademarks of VRChat Inc.

About

The better way to manage VRChat galleries.

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages