Collapse Launcher lets you replace the default game background with your own images or video files, apply a dynamic color theme derived from the background, and integrate with Discord and Steam.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/CollapseLauncher/Collapse/llms.txt
Use this file to discover all available pages before exploring further.
Custom background images
By default, Collapse shows the official background provided by the game’s HoYoPlay API for the currently selected region. You can override this with your own image on a per-region or global basis.Supported formats
| Format | Notes |
|---|---|
| WebP | Fully supported via built-in codec |
| HEIF / HEIC | Supported via built-in codec |
| AVIF | Supported via built-in codec |
| JXL (JPEG XL) | Supported via built-in codec |
| JXR (JPEG XR) | Supported via built-in codec |
| SVG | Supported as a vector image |
| Standard bitmap formats | PNG, JPEG, BMP, GIF, TIFF, and other formats supported by the Windows imaging pipeline |
| Video files | Supported via FFmpeg (see below) |
Setting a per-region background
Open the background picker
Click the Change Background button in the home page game management panel (or right-click the background to access the context menu).
LastCustomBg-{GameName}-{ZoneName}). Switching to a different region reverts to that region’s own background setting.
Setting a global background
In Launcher Settings, you can set a single global background that applies to all regions where no per-region custom background is configured. The global background path is stored under theGlobalBg configuration key.
Removing a custom background
Disable the custom background toggle for the current region (or globally) in Launcher Settings. Collapse falls back to the official API background, or to a placeholder image if the API does not provide one.Video backgrounds with FFmpeg
Collapse supports animated video backgrounds when FFmpeg shared libraries are present. The video plays in a loop behind the launcher interface.Required FFmpeg libraries
Collapse looks for the following DLL files alongside its executable:PATH environment variable and creates symbolic links to the DLLs it finds. You can also set a custom FFmpeg directory in Launcher Settings.
Enabling video backgrounds
Install FFmpeg
Download a shared-library FFmpeg build (the one that provides
.dll files, not a static build) and place the required DLLs either in the Collapse directory or somewhere on your system PATH.Enable FFmpeg in settings
In Launcher Settings, enable Use FFmpeg for video backgrounds. Collapse will verify the libraries are reachable and update its status indicator.
Video playback controls
When a video background is active, a small control bar appears on hover over the bottom of the launcher:| Control | Action |
|---|---|
| Play/Pause | Toggle video playback |
| Audio toggle | Enable or disable background video audio |
| Audio volume | Adjust the video audio level (0 – 100%) |
| Keep playing when unfocused | Continue playing video when the Collapse window loses focus |
Dynamic color theming
When a custom image is set, Collapse derives an accent color from the image content and applies it to the launcher UI. This affects button colors, highlights, and other themed elements throughout the interface. The accent color is extracted automatically when the background loads. No manual configuration is required.Parallax effect
Collapse applies a subtle parallax scroll effect to the background image as you move your mouse over the launcher. You can configure or disable this in Launcher Settings:| Option | Description |
|---|---|
| Enable parallax effect | Toggles the effect on or off (GlobalIsBackgroundParallaxEffectEnabled) |
| Parallax pixel shift | Controls how many pixels the background shifts at maximum cursor offset (GlobalBackgroundParallaxPixelShift) |
Multiple backgrounds
When a game region provides multiple backgrounds via the HoYoPlay API, Collapse displays all of them and lets you choose which one to use with a pager control at the bottom of the background. Hovering over the pager area reveals navigation dots and additional controls. You can also save backgrounds locally:- Right-click the background and choose Save current background or Save all backgrounds.
- Collapse creates a folder named
CollapseBackground-{ProfileName}in the destination you choose and saves each background as a numbered subfolder containing the background and overlay images.
Discord Rich Presence
Collapse integrates with Discord to display your current activity as a Rich Presence status. The presence updates automatically based on what you are doing.| Activity | Status shown |
|---|---|
| Launcher idle | Shows the Collapse logo and current game/region |
| Playing a game | Shows the game name, region, and elapsed play time |
| Updating a game | Shows update activity |
| Running repair | Shows repair activity |
| Updating cache | Shows cache update activity |
| Viewing game settings | Shows game settings activity |
Configuring Discord Rich Presence
In Launcher Settings:- Enable Discord RPC — toggle the integration on or off. When disabled, the presence is cleared from Discord immediately.
- Show idle status — when enabled, Collapse reports an idle presence even when you are not actively doing anything. When disabled, no presence is shown during idle.
DiscordRpcClient library. The presence is updated through a queue to prevent flooding.
System tray
Collapse runs in the Windows system tray when minimized or when the window is closed but a background operation is in progress. Tray notifications are used for:- Completed preloads, installs, and updates (when the window is not in focus)
- Cache check and update completions