Config file

From Zaparoo Wiki

Revision as of 06:32, 22 December 2024 by Wizzo (talk | contribs)

The config file is the main configuration file of the Core software service.

Where it's located depends on the platform on which the service is running. On MiSTer, it's located in the /media/fat/zaparoo folder or zaparoo folder in the root of the SD card. The file is always called config.toml on every platform.

The config file is written in TOML. Be aware that although comments are supported in TOML, they will be lost if Core makes updates to this file (e.g. when adjusting settings using the Zaparoo App) and should be avoided for important information.

Any changes made to the config file while the Core service is running require the service to be restarted before changes will take effect.

Options

Top-level

config_schema

debug_logging

audio

scan_feedback

readers

auto_detect

scan

mode
exit_delay
ignore_system

connect

driver
path

systems

default

system
launcher

launchers

index_root

allow_file

zapscript

allow_shell

service

api_port

device_id

allow_launch

Example file

An example config file with all fields filled:

config_schema = 1
debug_logging = true

[audio]
scan_feedback = true

[readers]
auto_detect = true

[readers.scan]
mode = 'hold'
exit_delay = 3.0
ignore_system = [ 'PC', 'MSX' ]

[[readers.connect]]
driver = 'pn532_uart'
path = '/dev/ttyUSB0'

[[readers.connect]]
driver = 'file'
path = '/tmp/some_file'

[[systems.default]]
system = 'SNES'
launcher = 'SindenSNES'

[launchers]
index_root = [
    '/media/alt_mount/games'
]
allow_file = [
    '/media/fat/something.mgl'
]

[zapscript]
allow_shell = [
    'touch /tmp/tap_time',
    '/media/fat/linux/mplayer something.mp4'
]

[service]
api_port = 7497
device_id = '4d01c19f-09ba-4871-a58a-82fb49f5b518'
allow_launch = [
    '*'
]