AtumOS — A Terminal Operating System

● § 01 · home

────────────────────────────────── gg or u to return

● System ready — kernel 6.8.0-atum

AtumOS

A keyboard-first operating system built on NixOS.
No mouse. No menus. No compromises.

jk scroll · : commands · ? help · t theme · np sections · gg · u top · G bottom

sys info

cpu ●●●●●●●●●● 72% · 96c/192t

mem ●●●●●●●●●● 12.1G / 256G DDR5

gpu RTX 4090 24GB

net ↑ 1.2M/s ↓ 4.8M/s

uptime: 14d 06h 21m · nix-24.11

atum@localhost:~ zsh 5.9 · nix

atum@localhost:~$

ls list files atumfetch system info clear clear screen help all commands

● § 02 · features

────────────────────────────────── press 2 to jump

# features

Everything you need.
Nothing you don't.

AtumOS ships a complete, opinionated environment tuned for keyboard-first workflows. No post-install configuration rabbit holes — open the terminal and start building.

⌨

Core · Modal System

Modal Editing, system-wide

Vi-style modal input isn't just for your editor here — it's the OS interaction model. Every panel, dialog, launcher, and application respects the same four modes. Learn once. Use everywhere.

NORMAL

INSERT

VISUAL

COMMAND

Escnormal · iinsert · vvisual · :command · Rreplace

Used in: neovim · sway · tmux · wofi · every system dialog

⚡

Performance · Zero Latency

Sub-millisecond input

Direct evdev input on Wayland. No X11 translation layer. No compositor input queue. Every keystroke lands in under a millisecond.

Input latency0.3ms

Render pipeline1.1ms

Typical X11 desktop~20ms

foot terminal · 240Hz · Wayland native · evdev direct

⊞

Window Management

Sway Tiling WM

i3-compatible tiling on Wayland. Workspaces, splits, floating, and scratchpads — zero mouse required. Every layout remembered per-workspace.

nvim

browser

term

ws1 · 3 windows

Modhjklvbf

◈

Theme · Design System

Gruvbox Everywhere

Gruvbox dark medium wired into every layer — terminal, WM borders, neovim, GTK3/4, Qt5, browser, dunst, and the SDDM lock screen.

16 colors · dark medium · terminal + GUI layers

⦿

Search · fzf

Fuzzy Everything

fzf wired into files, git, history, processes, kill, clipboard, and wofi. Type a fragment anywhere — the right result surfaces instantly.

> nix█

~/.config/atum/flake.nix

~/.config/atum/modules/nix.nix

/etc/nixos/hardware-configuration.nix

3/284 files

Ctrlp Ctrlr Ctrlt

⚙

Packages · NixOS

Declarative, reproducible

Your entire system — packages, config, dotfiles, services — in one flake. Every machine gets the exact same environment. Roll back any generation in seconds.

✓ Atomic upgrades — never half-broken

✓ Instant rollback at boot

✓ 80,000+ packages in nixpkgs

✓ home-manager for user config

# rebuild everything atomically

$ nixos-rebuild switch --flake .#default

# add a package declaratively

environment.systemPackages = [
pkgs.ripgrep pkgs.bat pkgs.eza
];

# roll back in one command

$ nixos-rebuild --rollback

⎀ Editor

Neovim + LSP

Full LSP, treesitter, telescope, lazy.nvim — pre-configured. Zero setup. Open a file and start coding.

SpaceSpace files gd def

⊛ System Info

atumfetch

AtumOS-native system fetcher — greets you on every shell open with kernel, WM, shell, uptime, and color palette.

atumfetch neofetch

Hz refresh

foot terminal

keybindings

pre-configured

0.3ms

input latency

evdev direct

% keyboard

no mouse needed

● § 03 · keymap

────────────────────────────────── press 3 to jump

# keymap

Every action, one keystroke away

Press ? at any time to see the full reference. Or explore below.

── Window Management

ModEnter Open terminal

Modhjkl Focus window

ModShifth.. Move window

Modv Vertical split

Modb Horizontal split

Modf Fullscreen

Modq Close window

── Workspaces

Mod1–9 Switch workspace

ModShift1.. Move to workspace

ModTab Next workspace

Mod` Prev workspace

Modc Scratchpad

── Terminal (tmux)

Ctrlac New pane

Ctrlahl Split panes

Ctrlanp Next/prev pane

Ctrla[ Copy mode

Ctrlaz Zoom pane

Ctrlad Detach session

── Editor (Neovim)

SpaceSpace Find file

Spacesg Live grep

Spaceld Diagnostics

gd Go to definition

K Hover docs

Spacern Rename symbol

── System

Modp App launcher (wofi)

ModShifte Exit AtumOS

ModShiftr Reload config

Modl Lock screen

PrtSc Screenshot region

── Media & Audio

XF86AudioUp Volume +

XF86AudioDown Volume -

XF86AudioMute Mute

XF86Play Play/pause (mpd)

XF86Next Next track

● § 04 · install

────────────────────────────────── press 4 to jump

# install

Up and running in under 10 minutes

AtumOS is a NixOS-based distribution. Everything is declarative — reproducible on any machine.

Requirements ⚙ x86_64 CPU ⊞ 4GB RAM min ◈ 40GB disk ⚡ UEFI firmware ● USB 2GB+ ✓ Any modern hardware

Installation steps

Download & Flash ISO

Grab the latest AtumOS ISO and flash it to a USB drive.

flash

dd if=atumos-24.11.iso of=/dev/sdX bs=4M status=progress && sync

Boot & Partition

Boot from USB, then use the guided disk partitioner.

partitioner

$ sudo atumos-partition --guided

Run NixOS Install

Install from the flake — your entire system in one command.

install

$ nixos-install --flake github:atumos/config#default

Rebuild & Switch

After first boot, apply your personal dotfiles and activate.

activate

$ home-manager switch --flake ~/.config/atum#me

You're Home

Press ? for all keybindings. Mod+Enter opens a terminal. Mod+p launches apps. Welcome to AtumOS.

tip: Something went wrong? NixOS lets you roll back any change instantly — just reboot and select the previous generation from the bootloader.

~/.config/atum/flake.nix

flake.nix

# AtumOS system configuration
{
  description = "AtumOS — keyboard-first NixOS";

  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.11";
    home-manager.url = "github:nix-community/home-manager";
    atum-config.url = "github:atumos/config";
  };

  outputs = { self, nixpkgs, ... }: {
    nixosConfigurations.default = nixpkgs.lib
      .nixosSystem {
        system = "x86_64-linux";
        modules = [ ./configuration.nix ];
      };
  };
}

What's included out of the box

⌨ Neovim + LSP ⊞ Sway WM ◈ tmux ⚡ zsh + starship ⦿ fzf + ripgrep ● Gruvbox everywhere ⚙ home-manager ◈ atumfetch ⚡ 312 keybindings

AtumOS 24.11

atumos-24.11-x86_64-linux.iso · 1.2 GB · sha256 verified

● § 05 · about

────────────────────────────────── press 5 to jump

# about

For those who believe
the mouse was a mistake

AtumOS is an opinionated NixOS distribution that puts the keyboard at the center of everything. Gruvbox throughout. Vi bindings everywhere. Reproducible by design.

g GitHub w Wiki m Matrix Chat