main
John Lauer Publish 0.1.0 d8a45ab

Hydrogen Settings: the preference tree

Open it from the Adom logo menu (upper-left) > Settings, or the tray menu's Settings. The canonical tree of sections and keys lives in src/lib/stores/settings.ts (settingsTree); on Linux forHost() hides the settings that do nothing here (listed below).

Preferences are saved per-user (saveUserSetting → PATCH /user/hydrogen/settings) and persist across sessions. Setting a key back to its default removes the override. Keys are dotted (section.subsection.name). They live in the Adom account's cloud key-value store (see hydrogen-key-values), so they follow the user to every machine.

Sections, keys, and what each does

general

Key Default What it does
general.developer_mode false Enables extra developer/debugging features in the app
general.pane_focus_mode false Only the focused pane is active and highlighted; turn it on to get the highlight
general.editor.workspace_folder project Folder VS Code opens: project = /home/adom/project, home = /home/adom

general.appearance (subsection)

Key Default What it does
general.appearance.theme adom-dark App-wide theme. Options: adom-dark, adom-light, adom-dark-high-contrast, adom-light-high-contrast (→ "change the theme" / "light mode" / "high contrast")
general.appearance.user_interface_style standard UI compactness: standard or compact (→ "make the UI more compact")

hydrogen.behavior additions (1.0.141+)

Key Default What it does
hydrogen.ai_threads_on_startup false Open the AI Threads panel at startup. BETA; while off, nothing AI-Threads-related runs. Add Panel can still open it for one session. Takes effect next start
hydrogen.show_lightbulb false Show the lightbulb (sample prompts) menu in the header. Applies immediately

More hydrogen.* keys

Key Default What it does
hydrogen.launch_on_boot false Open Hydrogen when you sign in to your desktop: writes or removes ~/.config/autostart/adom-hydrogen.desktop (XDG autostart, honoured by GNOME, KDE, Cinnamon and others)
hydrogen.color_scheme studio studio, studio-bright, studio-dark, kickstand, slate (whole app, editor included)
hydrogen.editor_code_font / hydrogen.editor_prose_font theme Code and prose fonts in the editor
hydrogen.editor_font_size 15 Editor and terminal text size, px
hydrogen.annotate.hotkey true Super+Alt+A starts annotate from anywhere (a desktop custom keybinding)
hydrogen.notify.remote_prompts, .ab_toasts, .remote_toasts true Prompts and toasts from your other machines and from Adom Bridge
hydrogen.nav_minimized false Compact Title Bar
hydrogen.close_button tray (quit with no tray) The window's X: tray hides Hydrogen to the desktop's tray (open the tray icon's menu > Quit Hydrogen to exit); quit exits. On a desktop with no tray icons (stock Fedora GNOME) the choices are quit (the default) and minimize; Quit Hydrogen is also in the Adom menu
hydrogen.show_approval_prompts true Show Adom Bridge approval prompts inside Hydrogen
hydrogen.link_open_mode remember Remember where each site's links open, or ask every time (see hydrogen-browser-picker)
hydrogen.show_progress_animation true The orbital animation on progress cards
hydrogen.assisted_signin false Narrate and click Authorize during sign-in; it relies on desktop automation Hydrogen does not have on Linux
hydrogen.watch_internet true Once a minute, check the workspace can reach the internet (header meter tooltip)
hydrogen.codex_care true Reopen dead Codex tabs and keep its backend in step
hydrogen.updater.* actions Check for updates now; apply a newer workspace image

On Linux the GPU preference, workspace networking mode, the recovery and wake group, the close notice and shutdown-on-close are hidden (forHost() in settings.ts): they do nothing here.

Dock Bar (dock.*): dock.groups.enabled, dock.hover.arm_delay (1800 ms), dock.hover.alt_pin, dock.visibility.reveal_at_launch, .start_collapsed, .collapse_on_launch, dock.ai.open_thread_on_launch.

adom_desktop (Adom Bridge)

These apply while Adom Bridge runs on this computer (Hydrogen installs it when a Linux build is published for the user's account).

Key Type / default What it does
adom_desktop.open action button Show the Adom Bridge window
adom_desktop.permissions action ab's approval mode (ask every time, 1 h, 24 h, Auto); granting is always the user's click in ab
adom_desktop.show_window_on_launch bool, false Show ab's window when Hydrogen launches
adom_desktop.exit_with_hd bool, true Ask ab to shut down when you quit Hydrogen

schematic (Schematic Workspace)

Key Default What it does
schematic.nudge_amount.small 1 px Arrow-key nudge distance for components
schematic.nudge_amount.large 8 px Shift+arrow nudge distance
schematic.invert_zoom_direction false Invert mouse-wheel zoom direction
schematic.default_cursor crosshair Default cursor: crosshair or pointer

3d (3D Settings)

Key Default What it does
3d.control_style fusion Orbit/pan/zoom control scheme: fusion, solidworks, or blender (→ "use blender/solidworks controls")
3d.invert_zoom_direction false Invert mouse-wheel zoom direction in 3D

code (Code Workspace)

Key Default What it does
code.appearance.font.family DM Mono Code editor font family (→ "change the code font")
code.line_numbers.enabled true Show line numbers (→ "hide line numbers" = set false)
code.line_numbers.style absolute Line-number style: absolute or relative
code.vim_emulation_mode false Vim motions in the code editor (→ "turn on vim mode" = set true)

simulator (Simulator Workspace)

Key Default What it does
simulator.code_editor_position right Code editor position relative to the 3D environment: right or left

extensions

Present in the tree but currently has no properties (reserved for future extension-specific settings).

Answering common asks

  • "Turn on vim mode" → code.vim_emulation_mode = true
  • "Change the theme / dark mode / high contrast" → general.appearance.theme
  • "Make Hydrogen start when I log in" → hydrogen.launch_on_boot = true
  • "Closing the window should quit" → hydrogen.close_button = quit
  • "Bigger editor text" → hydrogen.editor_font_size
  • "Change the colors" → hydrogen.color_scheme
  • "Blender / SolidWorks orbit controls" → 3d.control_style
  • "Hide line numbers / change code font" → code.line_numbers.enabled / code.appearance.font.family
  • "Make the UI compact" → general.appearance.user_interface_style = compact
  • hydrogen-adom-menu — the logo menu that opens Settings (and Ports, API Explorer, etc.)
  • hydrogen-ui — the broader Hydrogen UI / panel layout this dialog sits in
  • hydrogen-key-values: where the preferences are stored