Documentation

PlayfinityOS launcher guide.

This documentation helps you understand the launcher — how to add your games, use the gamepad hotkeys, organize your library, and get the most out of PlayfinityOS.

Front-end guide

Complete documentation

24 guides

ControllerGamepad hotkeysThe controller shortcuts: search, desktop, mouse mode, volume, and video quality.

What each item does

ASelect: The select button — it selects everything with the gamepad.
YSearch: Pressing Y in the main launcher brings the keyboard search.
YFavorite: Pressing Y in game details toggles Favorite.
ViewHome (tap): Brings the running game back to the front.
View(hold 2s)Go to Desktop: Shows the desktop; the right joystick becomes the mouse — left-click with A, right-click with B.
X+Start(hold 2s)Mouse mode: Turns mouse mode on and off — the right joystick becomes the mouse, A left-clicks, B right-clicks.
LT+D-PadVolume: Up/Down changes the Windows system volume with an on-screen HUD.
YVideo quality: In the game details video, pressing Y selects the quality.
D-PadDetails: In the game details video, Up/Down changes the volume; Left/Right seeks forward and backward.
LT / RTRead more: In game details, LT pages back and RT pages forward through the description.

LibraryLibrary view tabsThe left side of the top bar contains New, A-Z, Favorites, Last Played, and All.

What each item does

New: Sorts the games inside each Floor with the newest library additions first.
A–Z: Sorts game names alphabetically inside each Floor.
Favorites: Shows games you have marked as favorites across your Floors.
Last Played: Shows games with recorded launch activity and sorts the most recently played first.
All: Opens a combined grid and bucket view while retaining each game's original Floor identity.

Top barSearch, Refresh Library, Add Games, and SettingsThese four buttons appear in the right side of the top bar.

What each item does

Search Games: Opens the Search Games modal. It starts with an empty query and results list, accepts physical or on-screen keyboard input, and launches the selected result.
Refresh Library: Checks the folders and provider sources you have already added for new or updated games.
Add Games: Opens the Add Games modal popup. Its cards are Scan Folder, Import Steam, Import Xbox, Import EA, Import GOG, Import Ubisoft, and Import Epic.
Settings — Gamepad: The default console shell, built for the controller. Sections: Appearance, Screensaver, Wallpapers, Audio, Controls & Hints, System, About.
Settings — Desktop: The classic mouse-driven panel. Sections: Appearance, Screensaver, Wallpapers, Particles, Audio, Controls & Hints, Floors, System, About.

Good to know

Refresh Library scans for new games in the folders and Floors already in your library.
To add a new folder of games, use Add Games — Scan Folder. Provider games (Steam, Xbox, EA, GOG, Ubisoft, Epic) are scanned automatically, and new games land in the existing provider Floor.

Top barPower, screensaver, status, and window controlsThe remaining controls manage the PC session, show status, or control the PlayfinityOS window itself.

What each item does

Shutdown PC: Opens the Shutdown PC confirmation modal. SHUTDOWN confirms the operating-system shutdown; CANCEL closes the prompt.
Start Screensaver: Activates the screensaver immediately from the top bar.
Battery and clock: The clock is always present. Battery Status starts hidden and appears when battery information is available.
Minimize: Sends the PlayfinityOS window to the Windows taskbar while leaving the application open.
Close App: Opens the exit confirmation modal. The app closes only after the exit action is confirmed.

Before you continue

Shutdown PC is an operating-system power action, not an application-close action.

Add GamesAdd Games modalThe popup says “Choose how to add games to your library” and contains seven source cards plus Cancel.

What each item does

Scan Folder: Select a folder to scan.
Import Steam: Auto-detect Steam games.
Import Xbox: Auto-detect Xbox / Game Pass games.
Import EA: Auto-detect EA App games.
Import GOG: Auto-detect GOG Galaxy games.
Import Ubisoft: Auto-detect Ubisoft games.
Import Epic: Auto-detect Epic games.

Good to know

Select Cancel to close the popup without starting a scan.
Each card starts only its own source flow. The popup does not contain Scan All or Add Game Manually.

Local foldersScan FolderSelecting Scan Folder closes Add Games and opens the built-in Select Folder browser.

Follow these steps

01
Open Add Games and select Scan Folder.
02
Choose a drive, then open folders until the directory you want scanned is the current folder. Use the back arrow to return through visited folders.
03
Select SCAN NOW to scan the folder currently displayed in the browser.
04
The result is added to a new blue folder Floor named after the final folder in the selected path.

Good to know

The browser shows drive buttons, a back button, the current folder list, Cancel, and SCAN NOW.
Folder-list states in the current UI include Loading…, No subfolders found, Error loading folder, and Error: followed by the returned message.

ProvidersImport Steam, Xbox, EA, GOG, Ubisoft, or EpicEach Import card closes Add Games and starts the dedicated scanner for that provider only.

Follow these steps

01
Open Add Games and select the matching Import option.
02
The Add Games modal closes and the scan-progress overlay opens.
03
Detected games are saved and linked to an existing provider Floor, or a provider Floor is created when one does not exist.
04
The library refreshes after the provider operation completes.

Controls and choices

Import Steam: Runs the Steam scanner and uses the Steam Floor.
Import Xbox: Runs the Xbox scanner and uses the Xbox Floor.
Import EA: Runs the EA scanner and uses the EA Floor.
Import GOG: Runs the GOG scanner and uses the GOG Floor.
Import Ubisoft: Runs the Ubisoft scanner and uses the Ubisoft Floor.
Import Epic: Runs the Epic scanner and uses the Epic Games Floor.

Good to know

The popup has no combined provider scan. Select each Import card separately.

Scan resultsRead the scan progress and result statesThe scan window reports what PlayfinityOS is checking, how many games are detected, and whether the import finished successfully.

What each item does

Detecting: The selected provider or folder is being inspected. The overlay tracks Scanned and Detected counts.
Enriching: Artwork and metadata are being prepared for detected titles.
Saving: Detected games are being written to the local library.
Linking: Saved games are being connected to the matching Floor.
Finalizing: PlayfinityOS is refreshing the final library view.
Complete: The final state displays the number of provider or folder games ready.
Attention: The error state displays Scan failed.
No games detected: The scan completed, but the selected source did not produce a recognized installed game.

Good to know

The counters shown in the overlay are Scanned, Detected, Enriched, Saved, and Linked.
The overlay can display Still working messages while a scan or first-run metadata lookup continues.

Game cards · Edit GameOpen the game-card editorSelect the edit button on a game card to open the Edit Game modal for that library entry.

Follow these steps

01
Select the edit button displayed on a game card.
02
The modal title changes to Edit: followed by the game name.
03
Use the sidebar sections: General, Artwork, Media, Metadata, and Info.
04
Select Save Changes to apply edits, Cancel to discard them, or the close button to leave the modal.

Good to know

General is the active section whenever the editor opens.
Cancel or close restores an unsaved live background-position preview. Save Changes keeps the edited framing.

Game cards · GeneralTitle, executable, Sync, and launch argumentsGeneral contains the display title and the launch configuration used by the game entry.

What each item does

Game Title: Display name in your library. Enter the exact game title.
Sync: The Sync button fetches artwork and metadata automatically from the PlayfinityOS server for the entered title.
Executable Path: Path to the game .exe. Enter the path or select Browse.
Launch Arguments: Optional arguments saved with the game entry; the field example is -fullscreen -dx11 -high.

Before you continue

The frontend states that games or launchers configured to Run as administrator are not supported. Remove elevation to avoid a Windows UAC prompt during launch and restore.

Game cards · ArtworkEdit the card image and fullscreen backgroundArtwork provides separate Card Image and Background fields, previews, file browsing, and background framing controls.

What each item does

Card Image: Cover art shown on the game card. Enter an image URL or path, or use Browse local file.
Background: Fullscreen image shown when the game is selected. Enter an image URL or path, use Browse local file, or select Restore original background.
Background Position: The directional buttons move the background focal point up, down, left, or right in five-percent steps.
Reset: Returns Zoom to 1.0x and centers the focal point at 50% horizontal and 50% vertical.
Zoom: The slider ranges from 1.0x to 2.0x in 0.05 steps and updates the fullscreen background preview while it moves.

Good to know

Save Changes stores the selected image overrides and background zoom/focal-point values.
Clearing a changed Card Image or Background field returns that item to its enriched artwork value when saved.

Game cards · MediaReplace enriched screenshots and videosMedia starts with server-enriched media and exposes the custom editor only when Use Custom Media is enabled.

What each item does

Use Custom Media off: The section displays Using server-enriched media and keeps the custom editor hidden.
Use Custom Media on: Shows the custom Screenshots and Videos editors.
Screenshots: Add up to six local images with Browse. Supported picker extensions are JPG, JPEG, PNG, GIF, WebP, and BMP.
Videos: Add up to four entries by pasting a YouTube URL or video ID, then select Add.
Remove media: Each existing custom screenshot or video card includes a delete control and an order number.

Game cards · Metadata and InfoEdit descriptive metadata and read entry informationMetadata contains editable descriptive fields; Info contains read-only values for the current library entry.

What each item does

Genre: Text field with the example Action, RPG, Adventure.
Release Year: Text field for the displayed release year.
Rating: Slider from 0 to 10 in 0.5 steps; the displayed value uses the /10 format.
Description: Text area for the game description or summary.
Info: Read-only Source, Game ID, Floor, and Play Time values.

Settings · AppearanceWallpaper, glass, dimming, and title fontAppearance contains Wallpaper, Look and Feel, and Typography groups.

What each item does

Built-in: Choose from included wallpapers.
Random on Boot: Appears only under Built-in. When enabled, it selects a random built-in wallpaper on launch.
Dynamic: Background matches selected game.
Custom: Choose your own JPG, PNG, or WebP image with the Choose Wallpaper button.
Quantum Glass: Toggle UI transparency.
Background Dimming: The slider ranges from 0 to 95 and previews the overlay darkness while it moves.
Title Font: Style used for game titles: Barlow, Ubuntu, or Playfair.

Settings · ScreensaverScreensaverProtect your display when idle with cinematic ambient visuals.

What each item does

Enable Screensaver: Allows the screensaver to start after inactivity and dismiss on input.
Trigger After: Sets the idle delay to 5, 10, or 20 minutes.
Screensaver Style: Selects Matrix, Neuralis, or Clock.
Color: Uses the hue slider to select the screensaver color; the White preset returns to white.
Preview Screensaver: Starts a preview immediately. Move the mouse to return.

Good to know

When Screensaver is off, Trigger After is disabled and the style, color, and preview controls are hidden.

Settings · WallpapersChoose an included static wallpaperWallpapers presents the installed static wallpaper collection as a visual grid.

Follow these steps

01
Open Settings and select Wallpapers in the sidebar.
02
Browse the available image tiles.
03
Select the wallpaper you want to use. PlayfinityOS marks it selected, switches to Built-in, disables video wallpaper, and applies the image immediately.

Good to know

The current Wallpapers section contains the generated wallpaper grid and no separate enable switch.

Settings · Video WallpapersVideo WallpapersVideo Wallpapers lists supported background videos from the application's video wallpaper source.

Follow these steps

01
Open Video Wallpapers from the Settings sidebar.
02
Choose Custom Video to select an MP4, WebM, MOV, or MKV file, or browse the installed video tiles.
03
Select a video to enable and apply it as the background immediately.

Good to know

Selecting a video manages the video-wallpaper state automatically; there is no separate toggle in this section.

Settings · ParticlesParticle SystemParticles add a configurable foreground effect with selectable style, density, opacity, and color.

What each item does

Enable Particles: Turns the ambient particle layer on or off.
Constellation: Selects the Constellation particle style.
Snow: Selects the Snow particle style.
Frequency Waves: Selects the Frequency Waves particle style.
Aura: Selects the Aura particle style.
Density: Slider range: 20 to 240.
Opacity: Slider range: 0 to 100.
Color: Provides White and Black presets plus a 0-to-360 hue slider.

Good to know

When Enable Particles is off, the remaining controls are hidden and the animation loop pauses to save resources.

Settings · AudioSound EffectsAudio settings cover the master sound state and the volume of user-interface feedback.

What each item does

Master Sound: Enables or mutes PlayfinityOS interface sound effects.
UI Volume: Adjusts the level of navigation and interface feedback while Master Sound is enabled.

Settings · FloorsYour FloorsManage your game libraries — reorder, edit, or toggle visibility. Add a new Floor to organize your collection.

What each item does

Reorder: Use Move Up, Move Down, or the drag handle to change Floor order.
Show / Hide Floor: Changes whether a Floor appears in normal library browsing.
Edit Floor: Opens the inline Editing Floor panel with name, color, icon, Cancel, and Save controls.
Delete Floor: Immediately removes the selected Floor. The current flow does not show a confirmation dialog.
Add New Floor: Opens a custom Floor editor for a required name, color, and icon, then Scan Folder creates the Floor from the chosen directory.

Before you continue

Delete Floor has no confirmation step in the current interface.

Good to know

Floor rows can also be reordered by dragging their handle.
Provider imports are started from Add Games, not from the current Add New Floor editor.

Settings · FloorsAdd or edit a FloorAdd New Floor and Edit Floor use inline panels inside the Floors section rather than a separate Settings page.

What each item does

Add New Floor: Opens the New Floor panel with a required Floor name, color choices, icon choices, Cancel, and Scan Folder.
Scan Folder: Opens the folder browser and creates the custom Floor from the selected folder scan.
Edit Floor: Opens the Editing Floor panel with the current name, color, and icon.
Save: Applies the edited Floor name, color, and icon. An empty name is rejected.
Keyboard: Enter submits the active Floor editor and Escape cancels it.

Good to know

The current Add New Floor implementation creates a custom folder-based Floor. Provider cards remain in the Add Games modal.

Settings · ProfilesProfiles — Coming SoonProfiles are not configurable yet. Separate library profiles are planned for a later release.

What each item does

Current status: Coming Soon. No profile creation or switching controls are available.
What is planned: Separate library profiles with independent game collections and Floors.

Settings · SystemSystem and PowerSystem contains Auto-Detect New Games, Windows Startup, Reset Database, and Shutdown PC.

What each item does

Auto-Detect New Games: Instantly find games added to your library on launch.
Windows Startup: Launches PlayfinityOS automatically when Windows boots.
Reset Database: Clears the PlayfinityOS library, Floors, artwork/metadata records, and settings, then restarts the launcher. It does not delete installed game files.
Shutdown PC: Shuts down the Windows computer from inside Settings.

Before you continue

Reset Database is irreversible for launcher data and requires typing uppercase YES before CLEAR ALL is enabled. Shutdown PC closes the whole Windows session. Confirm you intend the full effect before using either action.

Settings · AboutAboutThe current About panel displays PlayfinityOS, Version 1.0.0, and the Release channel.

What each item does

Product: PlayfinityOS
Displayed version: Version 1.0.0 · Release channel

Still stuck?

Bring the screen and the version.

Include a screenshot of the issue and the version shown in Settings → About. That gives support the fastest path to the right answer.

Contact support [email protected]