Customization

Customization

Argosy is built for handhelds, so most of the default styling is already tuned for small screens and controllers. This page covers the options you can change under Settings > Appearance, Settings > Theme, and Settings > Interface.

Theme

Settings > Appearance > Theme cycles through:

• Light
• Dark
• System — follows your Android theme.

Accent and secondary color

Settings > Appearance > Accent Color and Secondary Color each expose a hue slider (0–360°). Tap to reset to the default accent. The app's highlight, focus, and button colors follow these values live.

Fonts, surface tint, and backdrops

The Theme section also covers the 2.0 additions:

• Font — load your own font files and apply them app-wide (dual-screen included), with a Font Scale slider for size.
• Surface Tint — one knob that tints panel surfaces toward your accent, visible even on the near-black dark theme.
• Backdrop — subtle monochrome patterns behind the home and menu surfaces, built from your accent color.

UI scale and grid density

Settings > Appearance also exposes:

• UI Scale — 50% to 150% in 5% increments. Useful on very small or very large screens.
• Grid Density — Compact / Normal / Spacious. Controls how tight game tiles and list rows pack together.

There is no separate font picker; text follows the Material 3 type scale at the chosen UI scale.

Home screen background

Settings > Interface > Home Screen controls the home screen backdrop:

• Installed Games Only — hide games you don't have downloaded, so the home screen reflects what you can actually play right now.
• Background — use the focused game's box art, or pick a custom image.
• Blur, Saturation, Opacity — sliders to tune the backdrop so foreground text stays readable.
• Video Wallpaper — play a short video preview behind the focused tile. Includes a delay (0–5 seconds) before playback starts and a mute toggle.
• Accent Color Footer — tint the footer hint bar with your accent color.

Sound effects

Settings > Theme > Sounds lets you pick a sound for each interaction:

• Navigate, Section Change, Select, Back
• Open Modal, Close Modal
• Favorite / Unfavorite
• Download Start / Complete / Cancel
• Error, Toggle, Volume Preview, Launch Game

Each event is set to one of four sources: Default (the built-in tone), RomM Music (a short clip from your server's music library — RomM 5.0+ only, hidden on older servers), Custom File (any local audio file), or Silent. Rows with a RomM track assigned show the track name with its platform and game.

With a sound row focused, press X to sample the assigned sound and Y to reset it to the default. When browsing RomM music for a sound, results are filtered to short clips; the maximum duration is adjustable in the filter menu (1–5 seconds, default 3).

Background music

Settings > Theme > Music:

• Background Music — enable / disable toggle.
• Volume — five levels from 2% to 35%.
• Music Playlist — manage your tracks: reorder, toggle individual tracks on or off, and see cover art.
• Browse Server Music — preview and download tracks from your RomM server (5.0+ only; hidden on older servers).
• Browse Local Music — add local files or folders to the playlist.
• Shuffle — randomize playback order across all tracks.
• Game Themes — when on, opening a game's detail page plays its title theme in place of the playlist (fading back on exit), if the game has soundtrack data on your RomM server (5.0+).
• Music Location — choose where downloaded soundtracks are stored; changing it offers to relocate existing files.

Everything plays from the playlist. Standalone tracks can be removed from it. A folder added via Browse Local Music becomes a synced source instead: its contents (subfolders included) appear in the playlist as individual tracks, new files show up automatically, and files deleted from the folder drop off. Folder-managed tracks are toggled off in place rather than removed.

Ambient LED (supported handhelds only)

Some emulation handhelds have addressable RGB LEDs. On those devices, Settings > Appearance > LED Control exposes:

• Enable — master toggle.
• Brightness — 0–100%.
• Custom Default Color — pick a hue for the idle state.
• Cover Art Colors — LEDs match a gradient pulled from the focused game's box art.
• Reactive Audio — LEDs pulse to the currently playing audio.
• Screen Colors — LEDs mirror the dominant colors on screen (requires screen capture permission).
• Achievement Flash: flash the LEDs when a RetroAchievement unlocks. Independent of the master toggle, so it works even with ambient LEDs otherwise off.

If your device doesn't have LEDs, this section is hidden.

Button icon swaps

Settings > Controls has toggles for:

• Swap A/B — swaps the confirm and cancel buttons both functionally and visually. The footer hints update to match, so prompts show the right icon for your physical layout.
• Swap X/Y
• Swap Start/Select

Useful on devices whose physical buttons use the opposite convention from Android defaults.