emuelec.conf file is the primary configuration file for EmuELEC, controlling system-wide settings like network, audio, and global emulator behavior. 1. File Location and Access You can find and edit the configuration file using these methods: Via Network (Samba): From a PC on the same network, type into the file explorer and look for the Direct SD Card Access: Remove the card and insert it into a PC. The file is typically located in the /emuelec/configs/ directory. Via SFTP/SSH: Use a tool like to connect to your device's IP (username: , password: ) and navigate to /storage/.config/emuelec/configs/emuelec.conf 2. Common Configuration Parameters The file is structured with key-value pairs (e.g., setting=value ). Lines starting with are comments and are ignored by the system. Description ee_ssh.enabled=1 Enables SSH access (default: 1). global.maxperf=1 Enables maximum CPU/GPU performance mode. wifi.enabled=1 Activates Wi-Fi (0 to disable). wifi.ssid=YourSSID Your Wi-Fi network name. wifi.key=Password Your Wi-Fi password (replaces with encrypted value after reboot). audio.device=auto Sets audio output (auto, hdmi, jack, etc.). audio.volume=100 Sets system volume level (0–100). ee_bootvideo.enabled=1 Toggles the startup video. global.shaderset=retro Applies a specific shader set (none, retro, scanlines). global.integerscale=1 Forces pixel-perfect integer scaling. 3. Advanced Customization Input Configuration: While most controller mapping happens in EmulationStation, specific emulator behaviors (like AdvanceMAME axis inversion) are set here using advmame_invert_axis=0 Menu Style: You can restrict menu access for "bartop" or "kiosk" modes using system.es.menu=default (or none/bartop). Control update checks with updates.enabled=1 and set the branch with updates.type=stable 4. Important Tips Backup First: Always create a copy of your working emuelec.conf before making manual edits. Escape Special Characters: If your Wi-Fi password contains characters like , you must escape them with a backslash (e.g., UI Overrides: Changes made directly in the EmuELEC "Danger Zone" or "EmuELEC Settings" menus within the device UI will overwrite manual changes in this file. Are you trying to fix a specific issue (like Wi-Fi connection or screen scaling), or are you looking to optimize performance for a specific handheld or TV box? EmuELEC-tests/README.md at master - GitHub

This report provides a technical overview of the configuration architecture in EmuELEC , a retro-gaming Linux distribution designed for Amlogic devices. EmuELEC Configuration Architecture Report The core of EmuELEC's customization lies in several key configuration files that govern system behavior, emulator settings, and user interface modes. 1. Core System Configuration ( emuelec.conf ) The emuelec.conf file is the primary configuration script located in the /storage/.config/emuelec/configs/ directory. It manages global hardware and software behaviors: System Services: Allows enabling or disabling SSH and Bluetooth at boot. Performance Profiles: Includes a global.maxperf setting to force maximum CPU/GPU settings for demanding emulators. Power Management: Configures auto-shutdown timers and persistence. Visual Personalization: Defines boot video settings and splash screen types (Legacy, Custom, Random, or Scraped media). 2. EmulationStation Settings ( es_settings.cfg ) This XML-based file controls the front-end (EmulationStation) and is typically found in the Emulationstation Config folder. UI Modes: A critical setting is UIMode . Changing this from "Kiosk" or "Kid" to "Full" is required to unlock advanced EmuELEC settings and menus. System Definitions: The related es_systems.cfg file tells the system where games are located and which platforms they correspond to for metadata scraping. 3. Emulator & Game Specifics ( emuoptions.conf ) While emuelec.conf handles global settings, emuoptions.conf stores specific configurations for individual games and emulators. Version Transitions: When upgrading between major versions (e.g., v3.9 to v4.2), users often copy the contents of emuoptions.conf into the end of the new emuelec.conf to preserve game-specific emulator choices and custom settings. 4. RetroArch Overrides Because EmuELEC uses RetroArch as its primary backend, standard RetroArch configuration files ( retroarch.cfg ) are used for input mapping and hotkeys. Hotkey Management: Users can define "enable hotkeys" to prevent accidental triggers or set them to "nul" for single-button execution. Input Mapping: RetroArch overrides are used to fix controller issues, such as analog-to-digital mapping for specific cores like N64. Summary of Key File Paths Configuration Type Common File Name Typical Directory Path Global System emuelec.conf /storage/.config/emuelec/configs/ UI/Front-end es_settings.cfg /storage/.config/emulationstation/ System Paths es_systems.cfg /etc/emulationstation/ Game Overrides emuoptions.conf /storage/.config/emuelec/configs/ RetroArch retroarch.cfg /storage/.config/retroarch/ Are you trying to fix a specific issue , like a controller not working or a game failing to launch? EmuELEC 4.0 RetroArch config issue #545 - GitHub

To configure , the primary file you will interact with is emuelec.conf [15, 16]. This file manages system-wide behaviors like SSH, Bluetooth, and global performance modes. 1. Key Configuration Files emuelec.conf : Located in the system's config directory, it handles core features like ee_ssh.enabled ee_bluetooth.enabled global.maxperf emuoptions.conf : Used for game-specific settings. In some versions, you can merge this into emuelec.conf to migrate settings between versions [6]. es_systems.cfg : Located at /etc/emulationstation/es_systems.cfg , this XML file tells the system which consoles are available, where games are stored, and which platforms to use for scraping [9]. 2. Common Configuration Parameters You can edit emuelec.conf using a text editor like Notepad++ via SFTP or by accessing the SD card on a PC [3, 18]. Default/Value Description ee_ssh.enabled Enable/Disable SSH access [15] ee_bluetooth.enabled Enable/Disable Bluetooth at boot [15] global.maxperf Forces maximum GPU and CPU performance [15] ee_auto_shutdown_timeout Minutes until auto-shutdown (0 is off) [15] ee_bootvideo.enabled Toggles the boot video on or off [16] 3. Setting Up a New System To get a basic configuration running on a generic Android TV box: Select DTB File : Navigate to the device_trees folder on your flashed SD card [2, 4]. Rename & Copy : Copy the file matching your hardware (e.g., RAM) to the root directory and rename it exactly to : Insert the card and hold the device's reset button while powering it on to force it to boot from the SD card [2, 4]. 4. Advanced Access Methods Samba/Network in your PC's file explorer while on the same network to access folders [3, 11]. with the username and password to edit files directly in /storage/.config/emuelec/configs/ For major updates or if settings aren't saving, you can use the "Danger Zone" menu in EmuELEC settings to "Reset EmuELEC scripts and binaries to default," which often fixes configuration conflicts while backing up your core settings [11, 17]. es_systems.cfg

Here are the main config files and their features:

1. emuelec.conf (main configuration file) Location: /storage/.config/emuelec/configs/emuelec.conf Purpose: Central settings for EmuELEC behavior. Key features you can modify:

Boot和行为 emuelec.bootvideo= – Enable/disable boot video emuelec.autostart= – Auto-start last played game emuelec.bezels= – Turn bezels (borders) on/off emuelec.shaders= – Enable/disable shaders globally

显示和渲染 gfx.retroarch.aspect_ratio_index= – Aspect ratio for RetroArch gfx.retroarch.smooth= – Bilinear filtering emuelec.games.menu= – Choose games list view (grid, list, detailed)

存储和保存 emuelec.storage= – Internal vs. external storage emuelec.saves= – Save games to internal or external

音频和输入 audio.device.alsa.0= – Output device system.language= – Change UI language

2. retroarch.cfg (RetroArch config) Location: /storage/.config/retroarch/retroarch.cfg Purpose: Core emulator settings used by most systems in EmuELEC. Features:

Overclocking the emulation via video_threaded = "true" or "false" Rewind feature: rewind_enable = "true" rewind_granularity = 1 Hotkey bindings: input_enable_hotkey_btn = "6" input_exit_emulator_btn = "7"

3. es_systems.cfg (EmulationStation systems) Location: /etc/emulationstation/es_systems.cfg or override in /storage/.config/emulationstation/ Purpose: Defines which system uses which emulator, ROM folder extension, and command lines. Features: