Skip to content
This repository has been archived by the owner on Oct 22, 2021. It is now read-only.

settings.json

Gaby edited this page Nov 17, 2020 · 29 revisions

The settings.json file stores all your parameters. This file is located in userData/settings.json.

Note: Since version 2.0.0, you can edit all the settings option directly in eDEX without manually editing the file. To access the settings editor, either use the CommandOrCtrl+Shift+S keyboard shortcut, or navigate to the userData folder in the filesystem display and touch/click the settings.json file.

The file is written on first start with only the necessary options, but there is a lot more you can customize in here. Listed below are all the accepted key/value pairs and what they affect.

Please note that incorrectly filling this file (for example with wrong types of values) might crash eDEX on start; if that happens, you can always delete the file and it will be written again with the default values next time you start eDEX.

Key Expected value Default value Description
shell (any CLI application) bash or powershell.exe The program to run in the "main shell" window.)
shellArgs (a string) '' Parameters to pass to the shell. e.g: '--login'
cwd (a directory path) userData The Current Working Directory in which the shell program will be started.
env (an array) undefined Replace the default settings for the shell's environment variables. Undefined falls back to eDEX's inherited env.
keyboard (a keyboard layout code) en-US Which keyboard layout to use.
theme (a theme name) tron Which theme to load.
termFontSize (an integer) 15 Size of the terminal text in pixels.
audio (a boolean) true Whether to activate sound effects or not.
audioVolume (a string w/ a number between 0.0 and 1.0) 1.0 App-wide audio volume for sound effects.
disableFeedbackAudio (a boolean) false Toggle for "feedback" sound effects like input/output and keyboard touch sounds.
port (a valid port number) 3000 The port to use for the websocket connection between your shell and the UI.
pingAddr (a valid IPv4 address) 1.1.1.1 Which address to use for testing Internet connectivity (default is Cloudflare's DNS)
clockHours (number 12 or 24) 24 Display the clock in 12 or 24-hours format.
monitor (a number) null Which monitor to spawn eDEX on. If the provided value is not a valid number, will default to the system's primary display.
nointro (a boolean) false Whether to skip the intro boot log & title screen. Also available as a --nointro command line switch.
nocursor (a boolean) false Hide the on-screen cursor. Intended for users of a touch screen. Also available as a --nocursor command line switch.
iface (the name of a network interface) null Select a custom network interface for monitoring. If this value is not a valid string, or if the selected interface disappears while eDEX is running, the monitor will fallback to automatic detection (the first external interface with a valid IPv4 and MAC address)
allowWindowed (a boolean) false Allow using the F11 key to switch eDEX to windowed mode.
forceFullscreen (a boolean) true See #830. Doesn't appear in the GUI configurator.
keepGeometry (a boolean) true Try to keep a 16:9 aspect ratio in windowed mode.
excludeThreadsFromToplist (a boolean) true Display threads in the top processes list
hideDotfiles (a boolean) false If set to true, files and directories starting with a dot (.) won't be displayed in the filesystem browser.
fsListView (a boolean) false Show files in a more detailed list instead of an icon grid in the filesystem browser.
username (a string) undefined Override the name used in the welcome message; normally your OS-level username is used.
experimentalGlobeFeatures (a boolean) false Toggle experimental features for the network globe. See #397
experimentalFeatures (a boolean) false Toggle Chrome's experimental web features. Useful for very advanced theming. May introduce security risks.
Clone this wiki locally