Adom Hydrogen (Linux)
Public Made by Adomby adom
The Linux platform layer for Adom Hydrogen: Ubuntu, Debian and Fedora, the workspace and the computer.
| Name | Last updated |
|---|---|
| docs | |
| hooks | |
| host | |
| screenshots | |
| skills | |
| install.sh | |
| package.json | |
| page.json | |
| README.md | |
| SKILL.md |
Adom Hydrogen (Linux)
The Linux platform layer for Hydrogen. On Linux, Hydrogen's workspace is a systemd-nspawn machine on your own computer; this package makes both the computer and the workspace ready for Hydrogen and its dock apps, on Ubuntu, Debian and Fedora.
adom/core
└─ adom/hydrogen-bootstrap (platform-generic Hydrogen layer)
├─ adom/hydrogen-windows-bootstrap (Windows, WSL2)
├─ adom/hydrogen-mac-bootstrap (macOS, Lima)
└─ adom/hydrogen-linux-bootstrap <- THIS: Ubuntu, Debian, Fedora
You never install this by hand: Hydrogen for Linux installs it in the workspace and runs its host half on your computer during setup and after every update.
Two halves
In the workspace (install.sh, then hooks/hydrogen-linux-platform-hygiene.sh after every
package update):
- ffmpeg with libx264 (AI runs that make video);
- the en_US.UTF-8 locale;
- Node 22 LTS when the workspace's Node is older than 20 (the official nodejs.org build, checked against its SHA256SUMS);
- earlyoom, told never to stop VS Code (its extension host runs every AI chat), Hydrogen or the AI CLIs, and to stop compilers, linkers and ffmpeg first;
- the AIs' sign-in sites trusted in VS Code, so their sign-in pages open without "Do you want to open the external website?".
On the computer (host/hydrogen-host-setup.sh): Hydrogen runs it with one password
prompt. It installs only what is missing, says what it is about to change, and changes nothing
on a second run. check changes nothing at all; Hydrogen Doctor uses it.
What it sets up
| Item | Why | Ubuntu / Debian | Fedora |
|---|---|---|---|
| H.264 playback | Hydrogen's webviews (WebKitGTK) play video through GStreamer; Adom's videos are H.264 High + AAC | gstreamer1.0-libav, -plugins-bad, -plugins-good, -vaapi |
RPM Fusion free (announced on screen), ffmpeg in place of ffmpeg-free, gstreamer1-plugin-libav |
| AppImage runtime | Grok Bot and the Adom Bridge AppImage need FUSE 2 | libfuse2t64 (24.04, Debian 13) or libfuse2 |
fuse-libs |
| Flatpak + Flathub | KiCad installs from Flathub | flatpak |
(present) |
| Flatpak apps in menus now | KiCad's icon and entry without logging out | links in ~/.local/share + environment.d |
same |
| Tray icon | Hydrogen lives in the tray when closed | Ubuntu has it; Debian GNOME: gnome-shell-extension-appindicator |
gnome-shell-extension-appindicator |
| Desktop portal | screenshots, screen capture, annotate | xdg-desktop-portal + -gnome, -xapp (Cinnamon) or -kde |
xdg-desktop-portal-gnome |
| Dictate audio | Hydrogen records the mic itself | PipeWire's pw-record (or pulseaudio-utils on PulseAudio) |
pipewire-utils |
| Clipboard tools | an annotate picture stays on the clipboard | wl-clipboard, xclip |
same |
| Notifications, links | Adom Bridge notifications, opening links | libnotify-bin, xdg-utils |
libnotify, xdg-utils |
| Out-of-memory guard | a full memory must not freeze the desktop, and never stops VS Code, Hydrogen or the AIs | earlyoom where systemd-oomd is not running (Debian), with Hydrogen's avoid and prefer lists |
systemd-oomd |
| Adom fonts | dashboards and tiles | Familjen Grotesk, Satoshi, JetBrains Mono in ~/.local/share/fonts |
same |
| Workspace time zone | the workspace follows the computer | set on every run | same |
| Google Chrome (optional) | only the native browser bridge needs it; your default browser is kept | Google's .deb | Google's .rpm |
In the workspace it also installs the libraries headless Chrome needs (libnss3, libnspr4,
libasound2t64, libgbm1 and the rest), so tools that drive Chrome there (Hero Studio, page
renders) work.
Known gap, next: tools in the workspace cannot reach the computer's Adom Bridge relay the way
adom-bridge ping does (Hero Studio's pup fallback answers "Adom Desktop did not answer
browser_status").
It also checks, and reports in Doctor: the Adom Bridge window list extension on GNOME Wayland (Adom Bridge installs it; it is active after logging out and in once), Adom Bridge's mesh (on, relay mode), firewalld for the mesh port, and the login keyring Chrome uses.
Checking a computer
bash host/hydrogen-host-setup.sh check
Hydrogen host check 0.1.0 on Ubuntu 24.04.5 LTS (ubuntu:GNOME, wayland)
h264 ok avdec_h264 decodes the High-profile sample
fuse2 ok libfuse.so.2 present (AppImages run)
flatpak ok flatpak with Flathub
tray ok Ubuntu's own AppIndicator extension
...
relogin means installed, active after logging out and in once.