DecodiumOS is a Linux distribution built for radio amateurs, derived from AnduinOS 2 (Ubuntu 26.04 “resolute”, a GNOME desktop styled after Windows). Instead of starting from a bare Ubuntu and installing every ham radio program by hand, it comes with the whole toolbox already in place and already themed — you write it to a USB stick, boot it, and it works.

One minute, double speed: the Start menu, Decodium decoding FT8, and installing a logbook program from the software store.

What's inside

Every set below is a group of packages you can include or drop with make menuconfig before building. Decodium itself is always installed — it is the one program the whole distribution is built around.

Set	Applications
—	Decodium 4 (latest GitHub release, SHA-256 verified)
`rig`	Hamlib (`rigctl`/`rigctld`), flrig, wfview
`digital`	WSJT-X, JTDX, JS8Call, Fldigi, flmsg, flamp, QSSTV, FreeDV
`logging`	TQSL (LoTW), KLog, Xlog, Tlf, Xdx
`packet`	Dire Wolf, AX.25 tools, Pat (Winlink), Xastir
`satellite`	Gpredict
`sdr`	Gqrx, rtl-sdr, SoapySDR, HackRF, Airspy, CubicSDR, Inspectrum, multimon-ng
`cw`	Aldo, qrq, morse, ebook2cw
`antenna`	xnec2c, nec2c, yagiuda, SPLAT!
`tools`	gpsd, CuteCom, minicom, pavucontrol, qpwgraph
`extra` (off by default)	CQRLOG, GNU Radio, gr-satellites, SatDump, Quisk, FBB, LinPac, soundmodem

System integration

CAT/PTT serial ports (ttyUSB*, ttyACM*) work immediately for the desktop user (udev uaccess), and the dialout group is added to every local user automatically at each boot
ModemManager no longer probes radio interfaces — its AT probes can key a radio or block CAT
GPIO PTT on C-Media CM108/CM119 chips works out of the box (Digirig, Dire Wolf)
More frequent NTP sync (256 s max poll) for FT8/FT4/FT2 timing
A Ham Radio folder in the Start menu, with Decodium pinned to the taskbar
ID=decodiumos, ID_LIKE="ubuntu debian", the Ubuntu codename kept — third-party PPAs and scripts keep working

Updating Decodium on an installed system:

decodiumos-update-decodium --check compares installed vs. available, sudo decodiumos-update-decodium installs the latest release.

Look and feel

DecodiumOS carries Decodium 4's “Ocean Blue” theme throughout the system — background #0A0F1A, blue #4A90E2, signal #00D4FF, decode #00FF88: boot screen, login screen, wallpapers, Start button, window colours, the ISO's GRUB menu, even fastfetch's logo. The installer, welcome app, driver centre and appearance settings all present themselves as DecodiumOS, in every language.

Download and verify

Download DecodiumOS 1.1.2 (amd64) ≈ 2.7 GB · ISO · UEFI

SHA-25680dc46e67e89e5df8d36b79364560d0f2bbd51d56dbf94ee833cce92c08ecf9e

To check the download is intact: on Linux or macOS, sha256sum DecodiumOS-1.1.2-2609131031-amd64.iso; on Windows, certutil -hashfile DecodiumOS-1.1.2-2609131031-amd64.iso SHA256. Compare the result against the hash above.

Writing the USB stick and booting

The installer that runs from the Live session: AnduinOS's own installer, rebranded as DecodiumOS.

Write the ISO to a USB stick of 8 GB or more with balenaEtcher or Rufus (Windows), or dd (Linux/macOS) — not a simple file copy.
Boot the target machine in UEFI mode from the USB stick.
Try DecodiumOS live, with nothing touched on the disk, or launch AnduinOS's native installer to put it on the machine permanently.

Build it yourself

The build host must be Ubuntu 26.04 (the codename has to match TARGET_UBUNTU_VERSION in args.sh), a non-root user with sudo, an internet connection, and plenty of free disk space.

git clone https://github.com/iu8lmc/DecodiumOS.git decodiumos cd decodiumos make menuconfig # optional: pick application sets, Decodium release… make

The ISO and its SHA-256 land in dist/. For ARM64: TARGET_ARCH=arm64 make. From Windows you can build under WSL2 (wsl --install -d Ubuntu-26.04), but the repository must be cloned into the Linux filesystem (~/decodiumos), not /mnt/c — debootstrap and chroot do not work on NTFS.

Known limits

Technical names stay AnduinOS's own: packages anduinos-*, the packages.anduinos.com repository, paths like /usr/lib/anduinos-installer-beta. Renaming them would mean recompiling and hosting all of those packages independently, losing AnduinOS's updates. DecodiumOS's own packages are named decodiumos-*.
The light theme is still the standard Fluent one; Qt apps follow their own theme (Decodium already ships its Ocean Blue colours).
The QEMU acceptance suite (make test) still checks for AnduinOS branding and needs adapting; unit tests only run on Linux.
ModemManager ignores all ttyUSB/ttyACM ports: old serial cellular modems are not handled.
A user created after installation joins dialout on the next reboot; desktop access works immediately thanks to uaccess.

Following AnduinOS upstream

DecodiumOS tracks AnduinOS 2's releases, not its master branch: releases use only packages from the public packages.anduinos.com repository, while master can depend on packages that exist only in the development repository. The current base is tag 2.0.2. All DecodiumOS changes live in separate mods, so upstream merges stay confined to a handful of files.

Licence and credits

GPL-3.0, like AnduinOS (see LICENSE and OSS.md). Built on the work of the AnduinOS / Aiursoft team. Decodium is by IU8LMC and contributors (Decodium 4). The ham radio applications come from the Ubuntu and Debian Hamradio archives, each under its own licence. The DecodiumOS wordmark uses Montserrat (SIL Open Font License 1.1).

Links and support

Download: ISO, amd64
Source code: github.com/iu8lmc/DecodiumOS
Decodium: Decodium-4.0-Core-Shannon
Community and support: Telegram channel
Email: iu8lmc@gmail.com

Frequently asked questions

Is this an official AnduinOS product?

No. DecodiumOS is an independent derivative built on top of AnduinOS 2's public releases, adding ham radio software and its own branding. All credit for the base desktop goes to the AnduinOS / Aiursoft team.

Do I need to know Linux to use it?

Not really — the desktop is styled after Windows on purpose, and every ham radio program is already installed and configured to see your radio's serial ports. You still need to know your own station and software, as with any operating system.

Can I just try it without installing anything?

Yes. Boot the USB stick and choose the Live session: nothing is written to the internal disk unless you deliberately run the installer.

Will my radio's CAT/PTT cable work right away?

Serial ports are accessible to the desktop user immediately and ModemManager is prevented from probing them, which is what usually causes a radio to key up or CAT to hang on stock Ubuntu.

Is there an ARM64 build?

The build system supports it (TARGET_ARCH=arm64 make), but only the amd64 ISO is published above for now.

Does it phone home or collect telemetry?

DecodiumOS itself adds no telemetry beyond what AnduinOS/Ubuntu already do. decodiumos-update-decodium only checks GitHub when you run it.

What if I don't want some of the applications?

Build it yourself with make menuconfig and drop the sets you don't need, or simply uninstall individual packages after installing — they are ordinary Debian packages.

Can I go back to plain AnduinOS branding?

sudo /usr/libexec/decodiumos/rebrand --undo restores the original AnduinOS files, which are kept alongside as *.anduinos.

73 de Martino IU8LMC

DecodiumOS è un sistema operativo Linux pensato per i radioamatori, derivato da AnduinOS 2 (Ubuntu 26.04 «resolute», desktop GNOME in stile Windows). Invece di partire da un Ubuntu nudo e installare a mano ogni programma radioamatoriale, arriva con l'intera cassetta degli attrezzi già pronta e già tematizzata: si scrive su una chiavetta USB, si avvia, e funziona.

Un minuto, a velocità doppia: il menu Start, Decodium che decodifica FT8, l'installazione di un logbook dal negozio software.

Cosa contiene

Ogni set qui sotto è un gruppo di pacchetti che si può includere o togliere con make menuconfig prima di compilare. Decodium è sempre installato: è il programma attorno a cui nasce tutta la distribuzione.

Set	Applicazioni
—	Decodium 4 (ultima release GitHub, verificata SHA-256)
`rig`	Hamlib (`rigctl`/`rigctld`), flrig, wfview
`digital`	WSJT-X, JTDX, JS8Call, Fldigi, flmsg, flamp, QSSTV, FreeDV
`logging`	TQSL (LoTW), KLog, Xlog, Tlf, Xdx
`packet`	Dire Wolf, strumenti AX.25, Pat (Winlink), Xastir
`satellite`	Gpredict
`sdr`	Gqrx, rtl-sdr, SoapySDR, HackRF, Airspy, CubicSDR, Inspectrum, multimon-ng
`cw`	Aldo, qrq, morse, ebook2cw
`antenna`	xnec2c, nec2c, yagiuda, SPLAT!
`tools`	gpsd, CuteCom, minicom, pavucontrol, qpwgraph
`extra` (non predefinito)	CQRLOG, GNU Radio, gr-satellites, SatDump, Quisk, FBB, LinPac, soundmodem

Integrazione di sistema

Porte seriali CAT/PTT (ttyUSB*, ttyACM*) accessibili subito all'utente del desktop (tag udev uaccess), e gruppo dialout aggiunto automaticamente a ogni utente locale a ogni avvio
ModemManager non sonda più le interfacce radio — le sue sonde AT possono mandare in trasmissione la radio o bloccare la CAT
PTT via GPIO dei chip C-Media CM108/CM119 già accessibile (Digirig, Dire Wolf)
Sincronizzazione NTP più frequente (poll massimo 256 s) per FT8/FT4/FT2
Cartella Radioamatore nel menu Start, con Decodium fissato sulla barra
ID=decodiumos, ID_LIKE="ubuntu debian", codename Ubuntu conservato: PPA e script di terze parti continuano a funzionare

Aggiornare Decodium su un sistema installato:

decodiumos-update-decodium --check confronta installato/disponibile, sudo decodiumos-update-decodium installa l'ultima release.

Aspetto

DecodiumOS porta il tema «Ocean Blue» di Decodium 4 in tutto il sistema — fondo #0A0F1A, blu #4A90E2, segnale #00D4FF, decodifica #00FF88: schermata di avvio, schermata di accesso, sfondi, pulsante Start, colori delle finestre, menu GRUB della ISO, persino il logo di fastfetch. Installer, app di benvenuto, Centro driver e Aspetto si presentano tutti come DecodiumOS, in ogni lingua.

Scaricare e verificare

Scarica DecodiumOS 1.1.2 (amd64) ≈ 2,7 GB · ISO · UEFI

SHA-25680dc46e67e89e5df8d36b79364560d0f2bbd51d56dbf94ee833cce92c08ecf9e

Per verificare che il file scaricato sia integro: su Linux o macOS sha256sum DecodiumOS-1.1.2-2609131031-amd64.iso; su Windows certutil -hashfile DecodiumOS-1.1.2-2609131031-amd64.iso SHA256. Confronta il risultato con l'impronta qui sopra.

Scrivere la chiavetta USB e avviare

L'installer avviato dalla sessione Live: lo stesso installer di AnduinOS, ribrandizzato come DecodiumOS.

Scrivi la ISO su una chiavetta USB da 8 GB o più con balenaEtcher o Rufus (Windows), oppure dd (Linux/macOS) — non basta copiare il file.
Avvia il computer di destinazione in modalità UEFI dalla chiavetta USB.
Prova DecodiumOS in Live, senza toccare il disco, oppure avvia l'installer nativo di AnduinOS per installarlo in modo permanente.

Compilarla da soli

L'host di build deve essere Ubuntu 26.04 (il codename deve coincidere con TARGET_UBUNTU_VERSION in args.sh), con un utente non root che usa sudo, connessione Internet e molto spazio libero su disco.

git clone https://github.com/iu8lmc/DecodiumOS.git decodiumos cd decodiumos make menuconfig # opzionale: set di applicazioni, release di Decodium… make

La ISO e il suo SHA-256 finiscono in dist/. Per ARM64: TARGET_ARCH=arm64 make. Da Windows si può compilare in WSL2 (wsl --install -d Ubuntu-26.04), ma il repository va clonato nel filesystem Linux (~/decodiumos), non in /mnt/c: debootstrap e chroot non funzionano su NTFS.

Limiti noti

I nomi tecnici restano quelli di AnduinOS: pacchetti anduinos-*, repository packages.anduinos.com, percorsi come /usr/lib/anduinos-installer-beta. Rinominarli vorrebbe dire ricompilare e ospitare in proprio tutti quei pacchetti, perdendo gli aggiornamenti di AnduinOS. I pacchetti di DecodiumOS si chiamano decodiumos-*.
Il tema chiaro resta quello Fluent standard; le app Qt seguono il proprio tema (Decodium usa già i suoi colori Ocean Blue).
La suite di accettazione QEMU (make test) verifica ancora il marchio AnduinOS e va adattata; i test unitari girano solo su Linux.
ModemManager ignora tutte le porte ttyUSB/ttyACM: i vecchi modem cellulari seriali non vengono gestiti.
Un utente creato dopo l'installazione entra in dialout al riavvio successivo; l'accesso dal desktop funziona subito grazie a uaccess.

Seguire AnduinOS upstream

DecodiumOS segue le release di AnduinOS 2, non il ramo master: le release usano solo pacchetti del repository pubblico packages.anduinos.com, mentre master può dipendere da pacchetti presenti solo nel repository di sviluppo. La base attuale è il tag 2.0.2. Tutte le modifiche di DecodiumOS vivono in mod separati, quindi gli aggiornamenti da monte restano confinati a pochi file.

Licenza e crediti

GPL-3.0, come AnduinOS (vedi LICENSE e OSS.md). Basato sul lavoro del team AnduinOS / Aiursoft. Decodium è di IU8LMC e contributori (Decodium 4). Le applicazioni radioamatoriali provengono dagli archivi Ubuntu e Debian Hamradio, ciascuna con la propria licenza. Il marchio DecodiumOS usa il font Montserrat (SIL Open Font License 1.1).

Link e supporto

Download: ISO, amd64
Codice sorgente: github.com/iu8lmc/DecodiumOS
Decodium: Decodium-4.0-Core-Shannon
Community e supporto: canale Telegram
Email: iu8lmc@gmail.com

Domande frequenti

È un prodotto ufficiale AnduinOS?

No. DecodiumOS è un derivato indipendente costruito sopra le release pubbliche di AnduinOS 2, con l'aggiunta del software radioamatoriale e di un marchio proprio. Il merito del desktop di base va interamente al team AnduinOS / Aiursoft.

Devo conoscere Linux per usarlo?

Non davvero: il desktop è volutamente in stile Windows, e ogni programma radioamatoriale è già installato e configurato per vedere le porte seriali della radio. Resta comunque necessario conoscere la propria stazione e il proprio software, come per qualsiasi sistema operativo.

Posso provarlo senza installare nulla?

Sì. Avvia la chiavetta USB e scegli la sessione Live: non viene scritto nulla sul disco interno a meno di lanciare deliberatamente l'installer.

Il cavo CAT/PTT della mia radio funzionerà subito?

Le porte seriali sono accessibili subito all'utente del desktop e ModemManager non può più sondarle: è di solito questo, su un Ubuntu normale, a mandare in trasmissione una radio o a bloccare il CAT.

Esiste una build ARM64?

Il sistema di build lo supporta (TARGET_ARCH=arm64 make), ma per ora è pubblicata solo la ISO amd64 qui sopra.

Raccoglie dati o telemetria?

DecodiumOS di per sé non aggiunge alcuna telemetria oltre a quella già presente in AnduinOS/Ubuntu. decodiumos-update-decodium contatta GitHub solo quando lo lanci tu.

E se non voglio alcune applicazioni?

Compilala da solo con make menuconfig e togli i set che non ti servono, oppure disinstalla i singoli pacchetti dopo l'installazione: sono normali pacchetti Debian.

Posso tornare al marchio AnduinOS originale?

sudo /usr/libexec/decodiumos/rebrand --undo ripristina i file originali di AnduinOS, conservati a fianco come *.anduinos.

73 de Martino IU8LMC