Launcher Settings
The Launcher Settings Dialog is where you configure the main behaviour and appearance of your launcher as a whole. While Page Settings control individual pages, Launcher Settings control the overall project, including the window, startup behaviour, music, cursor, and tray options.
A good way to think about this dialog is simple: if a setting affects the whole launcher rather than just one page, it usually belongs here.
What This Dialog Does
The Launcher Settings Dialog is split into clear sections in the sidebar, making it easier to manage your project without everything being dumped into one giant depressing wall of text.
Each section focuses on a different part of your launcher, such as project details, window setup, startup page, audio, cursor styling, and system tray behaviour.
Sidebar Navigation
The left side of the dialog contains different categories. Clicking a category switches the settings shown on the right. This keeps the dialog cleaner and makes larger launcher projects easier to manage.
Project Stats
At the bottom of the sidebar, the dialog shows a quick summary of your launcher, including the current page count and resolution. This gives you a handy overview while editing.
Basic Info
This section contains the core identity details for your launcher project.
Project Title
This sets the main title of the project. It is used as the launcher window title, so it should match the name you want users to see.
Author
This stores the creator name for the project. It is useful for identifying who made the launcher, especially if you are managing multiple projects.
Window Settings
This section controls the main launcher window itself, including size, shape, fullscreen behaviour, header styling, and transparency.
These settings define how your launcher feels when it first opens. A launcher can look sleek and modern, or like it escaped from a 2006 utility window, depending on what you choose here.
Width (px)
Sets the width of the launcher window in pixels. This controls how wide the launcher appears on screen.
Height (px)
Sets the height of the launcher window in pixels. This controls how tall the launcher appears on screen.
Corner Radius (px)
Rounds the corners of the launcher window. This only works when using a frameless window style. Higher values create more rounded corners, while lower values keep the edges sharp.
Start Fullscreen
When enabled, the launcher opens in fullscreen mode. This is useful for immersive launcher experiences or full-screen application dashboards.
Show Header Bar
Shows the standard operating system window frame and header bar. This gives the launcher a normal desktop window appearance with standard controls.
Header Bar Color
Lets you choose the colour of the window header bar when the header bar is enabled. This is useful when you want the launcher window to better match your brand colours.
Transparent Background
Allows the launcher window background to use transparency. This is useful for more advanced custom interface designs where you want the launcher to feel less like a normal boxed window.
If you enable fullscreen mode, the standard header bar is disabled. This is expected behaviour.
Start Page
This section controls which page is shown first when the launcher opens.
Initial Page
Selects the first page loaded when the launcher starts. This is usually your home page, dashboard, splash page, or main menu depending on how your launcher is designed.
Choose a starting page that immediately makes sense to the user. If the launcher opens to a random settings page or a dead-end panel, it looks broken even when it technically is not.
Background Music
This section lets you configure music that can play across the launcher.
Enable Music
Turns background music on or off for the launcher. When disabled, the music settings below are hidden.
Music File
Selects the audio file used for background music. This is the track that will be played when music is enabled.
Volume (0-100)
Controls the music volume. Lower values are quieter, while higher values are louder. A sensible default is usually better than trying to deafen the user before they even click Play.
Custom Cursor
This section allows you to replace the normal cursor with a custom one inside your launcher.
Use Custom Cursor
Enables or disables a custom cursor for the launcher.
Cursor File
Selects the cursor file or image used as the custom cursor. This is useful when you want the launcher to match a game's branding or visual identity more closely.
System Tray
This section controls whether your launcher can use a system tray icon and how it behaves when minimised.
For best results, use a proper .ico file at a high resolution. A tiny blurry tray icon makes even a polished launcher look like it lost a fight with Windows XP.
Enable Tray Icon
Turns the launcher tray icon on or off. When enabled, additional tray settings become available.
Tray Icon
Selects the icon used for the system tray. This is the small icon shown in the taskbar notification area.
Minimize to Tray
When enabled, minimising the launcher hides it from the taskbar and keeps it running in the system tray instead.
Saving Your Settings
Once you have finished editing the launcher settings, use the buttons at the bottom of the dialog to either save or discard your changes.
Save Settings
Saves the launcher configuration and applies the updated project settings.
Cancel
Closes the dialog without saving the changes made during the current session.
Quick Tips
- Use a sensible starting resolution so the launcher fits comfortably on most screens.
- Keep the Project Title clean and consistent with your branding.
- Only use fullscreen if the launcher is designed for a full-screen experience.
- Do not set background music too loud. Nobody wants jump-scared by menu music.
- Use a high-quality tray icon if you enable system tray support.
- Test custom cursors carefully to make sure they remain easy to see and use.
- Pick a clear Initial Page so users land somewhere useful straight away.
Launcher Settings control the whole project. If you want to style or animate just one page, use the Page Settings Dialog instead.