Settings Map

Where every setting lives

This page maps the Settings hub (Start in the main menu) page by page: each row as the screen shows it, what it does, and the key it is saved under. Fresh defaults are in DEFAULTS.md. Per-game settings (a game's Triangle menu) are listed at the end.

Unless a row says otherwise, keys are in the master configuration settings_riptopl.cfg (older builds wrote conf_riptopl.cfg; it is still read). Network keys marked (net) are in conf_network.cfg. Every key is defined in include/config.h and loaded and saved through the table in src/core/settings.cpp or through src/app/settingsio.cpp.

How the hub works

• The hub lists nine pages and Save Changes, and shows the running RiptOPL version under its title. Up and Down pick a page; Cross (or Circle, if swapped) opens it; L1 and R1 move between pages while one is open.
• Most changes take effect when you leave the page with OK, Back or L1/R1. On Game Sources, General & System, Network, Game Launching and PS Emulation Settings, Back or L1/R1 off the page without changing a row applies nothing; the other pages re-apply their rows even then. Audio rows and the Interface page's screen position, overscan and widescreen rows apply as you change them. Nothing is written to the memory card or device until Save Changes, except the cases in the next point.
• Leaving the hub with unsaved changes asks whether to save, exit without saving, or keep editing. Exit without saving restores the game-source choices (default device, start modes, source switches including PC CARD CF and DESR DVR ISOs, All Games List and Show Hidden Games, network protocol, SMB Version and UDPFS Access, MMCE options) as they were when the hub opened or at the last Save Changes inside it, and drops an unsaved HDD home-folder pick. It does not restore any other setting: those stay in effect for this session and are included in a later save.
• Four things write to the memory card at once, without Save Changes, and leaving the hub without saving does not undo them:
  • accepting the restart offered after a network protocol or SMB Version change that needs one: this saves every setting, including other unsaved changes, then restarts RiptOPL;
  • POPSTARTER Network Settings, on OK (POPSTARTER's own IPCONFIG.DAT and SMBCONFIG.DAT);
  • its POPS UDPFS Network Settings sub-page, on OK (SYS-CONF/IPCONFIG.DAT and UDPFSCONFIG.DAT, and POPSTARTER/PATHMAP.INI when one of its three switches changed);
  • PS Emulation Settings, when you leave it (OK, Back or L1/R1) with a changed BDMA Mode, or a changed BDMA Source while the mode is not FAT32: this equips or removes the BDMA driver files on the card. Equipping UDPFS also copies IPCONFIG.DAT and UDPFSCONFIG.DAT into SYS-CONF from the driver's POPS folder, each file on its own and only when the card lacks it and the folder has it; an existing file is left alone.
• Each setting has one row in one place. A button marked Modify opens a sub-page and returns to the page that opened it.
• Some rows exist only in some editions: RiptOPLite carries one game source, the RetroAchievements rows are only in RA editions, Controller Emulation and Macros only where PADEMU is built in, and the IGR menu only where it fits in the core.

Game Sources

Row	What it does	Key
Default Menu	The page the menu opens on.	default_device
HDD (APA) Start Mode	When the internal HDD (APA/PFS) page starts: Off, Manual or Auto.	hdd_mode
MMCE Start Mode	When the MMCE (SD2PSX, MemCard PRO2) page starts.	mmce_mode
MMCE Settings (Modify)	MMCE slot, IGR slot, Send GameID on Launch, communication and path settings (below).
BDM Devices Start Mode	When the block-device pages (the indented rows below) start.	usb_mode
Internal HDD (exFAT)	Lists games from an exFAT internal HDD.	enable_bdm_hdd
USB	Lists games from USB mass storage.	enable_usb
MX4SIO	Lists games from an MX4SIO SD adapter.	enable_mx4sio
PC CARD CF (experimental)	Lists games from a CompactFlash card in a PC Card adapter.	enable_pccf
DESR DVR (experimental)	Lists ISOs on a PSX DESR's DVR partition.	enable_dvr
iLink	Lists games from an i.LINK (FireWire) drive.	enable_ilink
Network Connectivity	When the network page starts: Off, Manual or Auto.	net_start_mode
Protocol	The same setting as Protocol on the Network page, shown here beside the start mode.	network_protocol, net_protocol_pick
Applications Page Start Mode	When the Applications page starts.	app_mode
Favorites Page Start Mode	When the Favorites page starts.	fav_mode
All Games List	One list of every game instead of a page per device. Same setting as Interface → Library.	all_games
Show Hidden Games	Lists games you hid.	show_hidden

MMCE Settings sub-page: MMCE Slot (mmce_slot), MMCE IGR Slot (mmceigr_slot), Send GameID on Launch (mmce_gameid), ACK wait cycles (mmce_wait_cycles), use alarms (mmce_use_alarms), MMCE Prefix Path (mmce_prefix).

General & System

Row	What it does	Key
Remember Last Played Game	Selects the last game you started when the menu opens.	remember_last
Auto Start	Seconds before the remembered game starts by itself (shown when the row above is on).	autostart_last
Browse Folders in Game List	Shows games in their folders instead of one flat list.	folder_nav
IGR Path	Where in-game reset exits to.	exit_path
Exit To	Where the main menu's Exit goes: Console Menu (the console's own exit, the default), PS2 Browser, or PS2 Browser (Skip Card Update). Only the main menu's Exit uses it.	exit_menu
Custom Settings Path	A folder to read and save settings in instead of the default.	custom_settings_path
Write Operations	Allows RiptOPL to write to game devices (rename, delete, VMC, art).	enable_delete_rename
Parental Lock Password	Password that locks protected games and settings.	parental_lock_password
Debug	Debug colours and logging during launch.	disable_debug
BDM Prefix Path	A folder on BDM devices that holds the game folders.	usb_prefix
ETH Prefix Path	A folder on the SMB share that holds the game folders.	eth_prefix
HDD Spindown	Minutes before the internal HDD spins down (0 = never).	hdd_spindown
Cache Game List (HDD APA)	Keeps the APA game list between starts.	hdd_game_list_cache
BDM Cache	In-game read cache for BDM devices (sectors).	bdm_cache
HDD Cache	In-game read cache for the APA HDD.	hdd_cache
SMB Cache	In-game read cache for SMB.	smb_cache

Language

Row	What it does	Key
Language	The menu language. See LANGUAGES.md.	language_text
OSD Defaults (Modify)	The language, aspect ratio and video mode games see from the console settings.	$CustomLanguage*, $OSD* (global game config)

Network

Rows under a protocol appear only while that protocol is selected. See HTTP.md for HTTP and RETROACHIEVEMENTS.md for the RA rows.

Row	What it does	Key
Protocol	SMB, UDPFS, UDPBD or HTTP.	network_protocol, net_protocol_pick
Access	UDPFS only: read-only or read/write.	udpfs_access
SMB Version	SMB only: SMB2/3 (new installs) or SMBv1.	smb_dialect
Advanced Options	Unlocks Ethernet Link Mode and the SMB port. Not saved.
Ethernet Link Mode	Auto or a fixed speed and duplex.	eth_linkmode (net)
IP Address Type	DHCP or static.	ps2_ip_use_dhcp (net)
IP Address, Mask, Gateway, DNS Server	The console's static address.	ps2_ip_addr, ps2_netmask, ps2_gateway, ps2_dns (net)
- SMB Server -: Address Type	IP address or NetBIOS name.	smb_share_use_nbns (net)
Address	The server's IP address or NetBIOS name.	smb_ip, smb_share_nb_addr (net)
Port	SMB port (Advanced Options).	smb_port (net)
Share, User, Password	The share and its login.	smb_share, smb_user, smb_pass (net)
HTTP server, HTTP port, HTTP base path	HTTP only: the catalogue server.	http_ip, http_port, http_base_path (net)
Test HTTP server (button)	Fetches the catalogue once and reports the result.
RA Mode, RA companion IP, RetroAchievements telemetry, RetroAchievements badges, RA mark in game list, Caduceus experimental cards	RA editions only.	ra_mode, ra_host_ip, ra_telemetry, ra_badges, ra_badge_suffix, ra_experimental_cards
OK / Reconnect	OK applies; Reconnect restarts the network connection with the new values.

POPSTARTER's own network files are edited from PS Emulation Settings → POPSTARTER Network Settings.

Interface

Row	What it does	Key
PS2/PS1 Game Display	Both (L3 switches), Mixed, PS2 or PS1 on each device page. See VCD.md.	default_game_view
Applications Display	How the Applications page lists apps.	apps_display
Video Mode	The menu's video mode (not the games'; that is GSM Defaults on Game Launching).	vmode
Theme	The menu theme. See INTERFACE.md.	theme
Theme View	List, Coverflow (3), Coverflow (5), PSBBN Flow or Grid; holding L3 cycles it too.	theme_view
Library	Pages or All Games. Same setting as Game Sources → All Games List.	all_games
Alternate Background	The theme's alt= background.	theme_alt_bg
Boot Theme Wait	Seconds the start-up screen waits for a saved theme's drive.	boot_theme_wait
User Wallpaper	Draws wallpaper.png from the settings folder behind the menu pages, in any theme (512x512 at most, 8-bit palette). See INTERFACE.md.	wallpaper
Show Legend	Shows the button legend on the menu and info pages; off hides it in every theme.	show_legend
Font Size	Small, Default or Large.	font_size
Button Glyphs	The theme's glyphs or a built-in set.	glyph_set
Coverflow Settings (Modify)	Center scale, animation speed, side-cover dimming, grid layout.	coverflow_scale, coverflow_anim, coverflow_dim, grid_layout
Artwork Settings (Modify)	Cover Art, Disc Artwork, Logo Artwork, Background Art, 3D Save Icons, Cover Art .tar Archive, Art Delay.	enable_coverart, enable_discart, enable_logoart, enable_bgart, enable_save_icons, enable_art_tar, art_delay
Colors (Modify)	Text, selected, UI, title, background and plasma colours, and Reset Colors.	text_color, sel_text_color, ui_text_color, title_color, bg_color, plasma_blend_color
Notifications	Shows short notices (device found, saved).	enable_notifications
Sort Games	Off, A to Z or Last played.	autosort
Automatic Refresh	Re-reads game lists while the menu is open.	autorefresh
Show CFG Titles in Game Lists	Uses the title from a game's CFG file. See CFG-TITLES.md.	cfg_titles_in_lists
List Title and Description	Theme, On or Off.	list_cfg_text
PS1 Duplicates	A PS1 game found for both cores: Both, Ember or POPSTARTER.	ps1_duplicates
Show [PS1]/[PS2] Labels	Marks each row with its system.	game_type_labels
Widescreen	16:9 menu.	wide_screen
H-POS, V-POS	Moves the picture (kept per video mode).	xoff, yoff
Overscan	Shrinks the picture to fit the TV.	overscan
Show GameID Barcode (Pixel FX)	Sends the game ID to Pixel FX scalers: All, POPSTARTER only, PS2 only or Off.	apply_gameid (PS2), popstarter_retrogem_gameid (PS1)

Game Launching

Row	What it does	Key
PS2 Logo	Shows the PS2 logo before a game.	ps2logo
App Handoff Path	Legacy (massN:) or typed (usb0:, ata0:) paths passed to apps.	app_handoff_path
Default Loader Core	OPL core or Neutrino for games with no choice of their own.	default_core
Automatic VMC	Creates a virtual memory card the first time a game starts. See AUTOMATIC-VMC.md.	auto_create_vmc
IGR Menu	The in-game reset menu (editions that carry it). See IGR.md.	igr_menu
GSM Defaults (All Games) (Modify)	The video mode games launch in unless a game has its own. See GSM.md.	$EnableGSM, $GSMVMode, $GSMXOffset, $GSMYOffset, $GSMFIELDFix (global game config)
Neutrino Path	Where neutrino.elf is. See NEUTRINO.md.	neutrino_path
Neutrino Video	Default video mode for Neutrino games.	neutrino_video_default
Neutrino GSM Fix	Default GSM type for Neutrino games (when Neutrino Video is on).	neutrino_gsm_comp_default
Neutrino Auto ELF, Show Neutrino Arguments	Neutrino launch options.	neutrino_elf_arg, neutrino_show_args
Neutrino Advanced Arguments (Modify)	Extra Neutrino arguments for every game.	neutrino_args

PS Emulation Settings

Row	What it does	Key
POPSTARTER.ELF Path	A full path to POPSTARTER.ELF, or empty for the default places.	popstarter_path
RetroGEM Game ID	Sends the PS1 game ID to RetroGEM. Same value as the PS1 half of Show GameID Barcode on Interface.	popstarter_retrogem_gameid
Ember Display Mode, Ember Timing, Ember Dithering, Ember Shading, Ember Controller	Global Ember defaults. A game's own Ember settings can override Timing, Dithering, Shading and Controller; Display Mode is global only.	ember_display_mode, ember_timing, ember_dither, ember_shading, ember_controller
BDMA rows	Apply on Launch, BDMA source, BDMA mode, USB BDMA.	bdma_apply_launch, bdma_source, vcd_usb_bdma
VCD Games List Settings (Modify)	Hide the PS1 game ID, first disc only, list PP.<ID>.POPS HDD partitions.	vcd_hide_gameid, vcd_first_disc_only, vcd_show_pp_pops
POPSTARTER Network Settings (Modify)	POPSTARTER's own IPCONFIG.DAT and SMBCONFIG.DAT on the memory card. See VCD.md §6.	(POPSTARTER's files)

Controller Settings

Row	What it does	Key
Menu Scrolling	Scroll speed.	scrolling
Select Button	Swaps Cross and Circle.	swap_select_btn
X Sensitivity, Y Sensitivity	Analog stick speed in the menu.	x_sensitivity, y_sensitivity
Menu Rumble	Vibration in the menu.	enable_rumble
Controller Emulation, Controller Macros (Modify)	Global PADEMU and macro settings (PADEMU editions). See PADEMU.md.	$PadEmuSettings, $PadMacroSettings (global game config)

Audio Settings

Row	What it does	Key
Sound Effects, Boot Sound, Background Music	Turns each on.	enable_sfx, enable_boot_snd, enable_bgm
Sound Effects Volume, Boot Sound Volume, Background Music Volume	0 to 100.	sfx_volume, boot_snd_volume, bgm_volume
Default BGM Path	The music file to play.	default_bgm_path

Per-game settings

Opened from a game's Triangle menu, saved in the game's own CFG file. Most of them have a Settings Mode row that picks between the game's own values and the global ones above.

• Game settings: loader core, DMA mode, DNAS ID, Console i.LINK ID (CONSOLE-ILINK-ID.md), alternate start-up, parental lock, compatibility modes, Neutrino arguments and video.
• GSM, Cheats, Controller Emulation, Controller Macros, OSD settings, Ember settings and VMC each have their own page.

Moved rows (for anyone used to an older build)

Each of these used to be reachable from two or three pages and is now on one:

Row	Now only on
GSM Defaults (All Games)	Game Launching (was also on General & System and Interface)
VCD Games List Settings	PS Emulation Settings (was also on Interface)
POPSTARTER Network Settings	PS Emulation Settings (was also on Network)
PS2/PS1 Game Display	Interface (was also on PS Emulation Settings)
Video Mode	Interface (a second copy in a separate display table is gone)

No key changed: a configuration saved by an older build loads unchanged.

---

Source: docs/SETTINGS.md @ df8c1ded2b17.