GammaOS logo GammaOS Nano
GitHub

Everything you can tweak in GammaOS Nano lives in one place: the Settings category. This page walks the whole tree top to bottom, so you always know where a given option lives and what it does.

You can open Settings two ways:

  • From the home screen, move to the Settings category and open the row you want.
  • From anywhere, hold Power to bring up the Quick Menu, then choose System Settings.

The Settings screen adapts to whichever home theme you are using. It looks like a PlayStation-style list on XMB and a clean text list on Minima, but the rows and options are the same.

Settings on the XMB theme
GammaOS XMB
Settings category
Settings on the Minima theme
Minima
same Settings, minimal look

Want the fastest way to change screen brightness? You do not need Settings at all. Just hold Select and press Vol + or Vol - from anywhere.

Top of the tree

Row What it does
User Guide A built-in how-to for the launcher.
System Update Install a system update over the air or from USB.

Game Settings

Controls your game library. See Adding Games, Game Systems, and Boxart for full walkthroughs.

Option What it does
Rescan Games Re-scan your ROM folders after adding or removing files.
Boxart Scraper Download cover art and metadata (see below).
Game Systems Enable, disable, reorder, and edit every game system.

Game Systems editor

Opening Game Systems lists every system with an On/Off toggle. Reorder systems with L1 and R1. Open a system to edit these fields:

  • Display Name and Short Name
  • Launch Type (Libretro Core or Custom Package)
  • Emulator (a searchable core or app picker)
  • Core .so, Package, Intent Template, Launch Args
  • Extensions (comma-separated file types this system accepts)
  • Scan Folders (a folder picker, or the default ROMs/<id>/)
  • Icon (a grid of icons or a custom PNG) and Icon Tint (21 swatches or a custom RGB colour)
  • A per-system Scraper with optional username and password, plus Scrape This System
  • Reset-to-Default for built-in systems, or Delete for custom ones

To add a system that is not in the list, use Add New System... at the bottom. Full steps are on the Custom System page.

Boxart Scraper

Option Default What it does
Scraper service ScreenScraper Choose ScreenScraper or TheGamesDB.
Replace Icons with Boxart On Show downloaded covers instead of system icons.
Hover Background Art On Show fanart behind the highlighted game.
Scrape Region - Preferred region for the art.
Overwrite Existing Off Re-scrape games that already have art.
ScreenScraper account blank Optional username and password (built-in credentials are used if blank).
TheGamesDB API key - Your own key for TheGamesDB.
Scrape All Systems - Kick off a full-library scrape.

Art is cached on the device and a background thread keeps scraping while you are idle. See Boxart for the full guide.

Video and Music Settings

These two rows control the streaming browsers in the media players.

Video Settings

Option Default What it does
IPTV Channels On Show the live-channel (IPTV) browser in Video.
IPTV Playlist URL - Point IPTV at your own playlist.

Music Settings

Option Default What it does
Internet Radio On Show the Internet Radio browser in Music.
Radio Playlist URL - Point Internet Radio at your own playlist.

System Settings

Option What it does
System Name Set the name shown for this device.
System Language Pick your language, with a live preview across many languages.
USB & Docking Set the USB connection to File Transfer (MTP) or Charge Only, so you can move files to a PC without ADB.

USB File Transfer (MTP)

Apps that declare storage and microphone permissions are granted automatically (you can still revoke them later in the full Settings app), and permission dialogs are controller-navigable, with the confirm button focused and activated by your controller.

Developer Options

For power users and debugging. Leave these off unless you know you need them.

Option What it does
USB Debugging Enable adb over USB.
Stay Awake While Charging Keep the screen on while plugged in.
Show Touches Draw a dot where you touch the screen.
Pointer Location Overlay touch coordinates and tracks.
Transition / Window / Animator scales Speed up or slow down system animations.

Theme Settings

The heart of the launcher's look. See the Themes page for the full tour.

Option What it does
Home Theme Switch between GammaOS XMB, DSi Menu, and Minima (applying restarts the home).
Colour Accent colour, 21 options including each theme's Original.
Background XMB background style (Original / Classic / Wallpaper).
Wallpaper and Wallpaper Image Pick a photo for the home background.
Bottom Wallpaper A separate wallpaper for the bottom screen (dual-screen devices).
Video Wallpaper A looping video for the top-screen background.
Clear Wallpaper Remove a custom wallpaper and restore the wave.
Background Colour A solid colour for the Minima background.
Wallpaper Dimming Darken a bright wallpaper so text stays readable (0 to 70%, default 25%).
XMB Wave Turn the PS3 wave on or off (auto-off when a wallpaper is set). Also available as an opt-in in Minima.
Font XMB font style (Original / Rounded / Pop).
Font Size Scale the launcher's text live in every theme (XMB, DSi and Minima); word-wrapped text reflows as you change it.
Day/Night XMB lighting (Auto / Day / Morning / Dusk / Evening / Night; default Night).
Dark Theme (DSi) While the DSi theme is active, flip the whole DSi look (carousel, top screen, info page, dialogs, status bar and tile cards) to light text and icons on a dark field, live.
Dual Screen (DSi) On dual-screen devices, choose Auto, Top+Bottom, or Carousel-Only.
Screen Gap (DSi) Tune the spacing between the stacked screens on portrait dual-screen panels.
Bottom Clock Turn the bottom-screen clock on or off (dual-screen devices).
Bottom Clock FPS 30 or 60 frames per second for the clock.
Home Categories Reorder or hide the home categories (see below).

Font scaling across themes

Rows that belong to a theme you are not using are hidden, so Theme Settings only shows what applies to your active theme. See the Themes page for the full look-and-feel tour.

Home Categories editor

Home Categories opens an editor for the top-level home columns. Hide columns you never use and reorder them with L1 and R1, and drill into a category to hide individual rows too. Quick Menu stays first, Settings cannot be hidden, and at least one category must stay visible. Changes apply live and persist.

Date and Time Settings

Option What it does
Set via Internet (NTP) Sync the clock over the network.
Set Manually Type in the date and time yourself.
Date Format Choose how dates are shown.
Time Format 12-hour or 24-hour clock.
Time Zone Pick your zone.
Daylight Saving Toggle daylight saving.

The DSi top-screen clock and the Minima status-pill clock follow your Time Format (12-hour or 24-hour), and the DSi date follows your Date Format.

DSi/Minima clock format

Power Save Settings

Option What it does
Battery Saver Reduce performance and background activity to stretch battery life.

Accessory Settings

Option What it does
Manage Bluetooth Devices Pair and manage Bluetooth controllers, headsets, and other accessories.

Gamepad Settings

Tune how your controller behaves across the whole system. For the full breakdown, including button remapping, calibration, and Mouse Mode, see Gamepad & Remapping. For the button map in the menu, see OS Controls.

Option What it does
Controller Enable Turn controller input on or off.
Merge Controllers Combine multiple pads into one virtual controller.
Hide Source Device Hide the raw input device from apps.
ABXY Swap Swap the face-button layout.
Invert Left / Right Stick Flip axis direction per stick.
Analog-to-D-Pad Let the analog stick act as a D-Pad.
D-Pad-to-Analog Let the D-Pad act as an analog stick.
Global Sensitivity Overall stick sensitivity.
PWM (rumble) Enable + Intensity Turn rumble on and set its strength.
D-Pad Threshold How far the stick must move to register as a D-Pad press.
Screen Map Map a stick to on-screen touch coordinates.
Mouse Mode Stick or D-Pad pointer speed, boost, and scroll (see Mouse and Keyboard).

Slide Behaviour

For devices with a slide, swivel, or hall (lid) switch. Configure what happens when you open or close, including the PSP-style clock. See the full page: Slide & Rotate Clock.

Option What it does
Enable Turn slide handling on.
Device / Button Code / Event Type / Active Value Tell the system which hardware switch to watch.
On Slide Down / On Slide Up Choose an action: Rotate, Sleep, Wake, Launch, or PSP Clock.
Sleep delay How long before sleeping after a slide.
Rotation angle Angle to rotate the screen on a slide.
Launch target App to open on a slide (with the Launch action).
Show clock on slide and Live backdrop Visual extras for the slide.
Parallax calibration Fine-tune the motion effect.

Display Settings

Option What it does
Brightness Screen brightness (or use Select + Vol + / Vol - anywhere).
LiveDisplay Night Light and temperature, colour calibration, saturation, and reading mode.
Screen Saver Configure the screen saver.
Screen Timeout 15 seconds up to Never.
Font Size Make system text larger or smaller.
Dark Theme System dark mode.
Screen Orientation / Force Orientation Set or lock the screen orientation.

When you boot into normal Android (desktop/TV) mode instead of Nano, screen orientation gets its own dedicated screen and the custom TvGammaShade notification shade becomes available. Those desktop-mode features are covered on the Full-Android desktop features page.

Sound Settings

Option What it does
Touch Sounds Play a sound on touch.
Charging Sounds Play a sound when charging starts.
Screen Lock Sounds Play a sound on lock and unlock.
Navigation Sounds Turn the launcher's UI navigation sounds on or off (the boot jingle still plays).

Network Settings

Your connections live here. See Network and Network Shares for the full guides.

Option What it does
Connection status list See your SSID, IP address, and signal.
Internet Connection Turn networking on or off.
Internet Connection Settings The Wi-Fi and Bluetooth setup wizard (pick an SSID, enter a WPA2 password, pair devices).
Internet Connection Test Check that you are really online.

The top bar (HUD) shows your Wi-Fi signal and Bluetooth status at a glance.

Tools and extras (their own rows)

These rows open dedicated tools rather than a simple list of toggles.

Row What it is
GammaOS Toolbox Power-user tweaks: performance, display, audio, swap, the RetroArch Back Button, and more.
GammaRGB RGB LED lighting: effect (Off / Follow Screen / Solid / Effect 1-5), colour, brightness, scale-with-brightness, speed, saturation, fade, split zones with per-zone colours. Effect > Off now truly powers the LEDs off, solid colours display vividly at full brightness, and there is a full-screen d-pad HSV colour picker with a live hex readout.
GammaEQ Speaker EQ and enhancements: master enable, speaker-only, preview, preamp and postgain, Crystalizer, Bass Limiter, Mid Protector, Stereo Widener, and two parametric EQ bands.
File Explorer Browse and manage the files on your device.

If you see a Storage row, its status text only reports how much space is used or free; it is not where you manage files. To browse, move, delete, or format storage, open Applications > Files (the standard file manager, fully controller-navigable) or the File Explorer row above. | Network Shares | Connect SMB, NFS, WebDAV, and FTP shares. |

RGB d-pad HSV picker

Quick Menu

The Quick Menu gives you fast access to brightness, performance, shaders, USB mode, and power, from the home or right over a running game. It has its own page: Quick Menu.

The Minima Quick Menu

In short, it includes:

  • Screen Brightness slider
  • Performance Mode
  • Quick Settings tiles
  • System Settings (jump into the full Settings app)
  • Global Shaders
  • Notifications
  • USB Settings (Charging only / MTP / PTP / RNDIS)
  • Close / Kill Apps
  • A Power submenu (Restart / Power Off / Recovery / Safe Mode / Boot Android)

If a screen shader ever makes the display unreadable, hold Power + Select together to disable the system display shader. This is the emergency escape hatch.

GammaOS Nano is community software. This wiki is maintained alongside the OS.