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 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 > Interface > UI Sounds lets you pick a tone 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 has a dropdown with 15+ preset tones (Tap Light, Pop Confirm, Buzz Error, Swipe Back, etc.) plus Silent. You can leave any event silent.

Background music

Settings > Interface > Background Music (or Settings > Sounds > Background Music):

• Enable / disable the toggle.
• Volume — five levels from 2% to 35%.
• Music file — pick a single audio file, or a folder of music.
• Shuffle — enabled when a folder is selected.

The now-playing track is shown when a folder is in use.

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.