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 > Theme and Settings > Interface.

Theme

Settings > Theme > Mode cycles through:

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

Accent and secondary color

Settings > Theme > 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.

Settings > Theme > Accent Color Footer tints the footer hint bar with your accent color.

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 separate Display Scale and Body Scale sliders for headings and body text.
• 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.

Interface

Settings > Interface exposes:

• UI Scale — 50% to 150% in 5% increments. Useful on very small or very large screens.
• Compact Footer — a thinner control guide bar, for when you want the hints without the height.
• Controller Grip — shifts the interface up out of the area a clamp-on controller covers in portrait.

Opening Controller Grip gives it three settings:

Setting	What it does
Mode	Off never shifts, On always shifts in portrait, and Automatic shifts only while one of your chosen controllers is connected
Controllers	Which controllers Automatic watches for. Pick them from the ones your device has seen
Reserved Height	How much to keep clear, 5% to 40% in 5% steps

Controller Grip only applies in portrait, and only on the device's own screen — a connected display or the dual-screen companion is never shifted.

Settings > Interface > Library > Grid Density — Compact / Normal / Spacious. Controls how tight game tiles and list rows pack together.

Home screen

Settings > Interface > Home Screen is split into Layout, Content, and Background.

Layout picks between the carousel, the auto grid, and the custom grid, and exposes the options belonging to whichever one is selected. See Home Screen Layouts.

Content:

• Installed Games Only — hide games you don't have downloaded, so the home screen reflects what you can actually play right now. Hidden under the custom grid, where you place every tile yourself.

Background and Video Wallpaper only appear under the carousel layout; a grid fills the screen with covers, leaving nothing behind it to tune.

• Background — cycles between Game Art and the backdrop Pattern. Only shown while the Theme backdrop is on; with it off the art layer always draws.
• Game Artwork — use the focused game's cover as the background.
• Custom Image — pick your own image instead (shown when Game Artwork is off).
• Blur, Saturation, Opacity — sliders to tune the backdrop so foreground text stays readable.
• Show Video Wallpaper — play a short video preview behind the focused tile. Delay Before Playback is Instant, 1, 3, 5, or 10 seconds, and Muted Playback silences it.

Sound effects

Settings > Audio > 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 > Audio > 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 > Displays > 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.
• Audio Brightness — LEDs pulse brightness with the currently playing audio.
• Audio Colors — color intensity shifts between bands with the 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 > Navigation 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.