A retro-futuristic dynamic Hyprland + Noctalia desktop theme after the 1984 Macintosh, 1-bit black and white, red accents, my logo (interchangeable) and a little Japanese. Adapts to the time of day: Light by day, dark after sunset, built for OLED screens (prevents burn-in).
The animated background, sped up about 20×

Dark and light mode. Light/dark follows the sun on its own.
Dolphin with the pixel file icons next to nvim and Zen, and FUTC-OS in Zen after dark.
| Night | Day |
|---|---|
![]() |
![]() |
time-lapse (15× speed)
The screensaver (3× speed)
More in docs/screenshots/.
- Windows: square corners, 2 px borders and a hard offset drop shadow on the focused window. No blur. Inactive windows are slightly see-through.
- Red only flashes: the border flashes red for 0.2 s when focus changes; hover, selection and errors are red; nothing stays red on screen.
- Animated background: a slow, dithered sky with banded clouds, a striped retro sun, then a moon and wheeling stars at night. Every two minutes a vertical Japanese caption fades in and out, with the small red bird above it and a red 鳥 seal below (おはよう, こんにちは, 夕焼け, おやすみ by time of day). Sun and moon follow your real sunrise and sunset. The whole frame orbits a few pixels so nothing sits still on an OLED.
- Light and dark: follow the sun (Noctalia
mode = "auto"), with an ordered-dither dissolve between them. - Screensaver: after 3 minutes idle, near-total black with the red bird trailing white ghosts and a drifting Departure Mono clock. Screens turn off after 10.
- Bar and shell: Noctalia gets the palette, Departure Mono, square panels, pixelated icons and kanji workspace numbers (一 二 三 …). Through Noctalia's templates, kitty, Alacritty, GTK, Qt and btop follow along.
- File icons: two pixel icon themes for Dolphin and other Qt/KDE apps, with outlined folders and documents after the 1984 Finder and a small pixel glyph for the type (code, image, archive, home, downloads …). They switch with light/dark; apps that are already open keep the old icons until restarted.
- Terminal:
bin/system1-fetchruns fastfetch with the bird instead of the distro logo, drawn in with a red dither wipe that settles into the text colour. It lists only the hardware (CPU, GPU, memory, disks, displays …), no network. With System 1 off it is plain fastfetch. - Claude Code: two custom themes (
claude/themes/, made byclaude/make-themes.pyfrom the palette) with black/white text, readable greys and red instead of orange.system1-modeswitches Claude Code between them with light/dark.claude/statusline.pyis a status line with context use, the 5-hour and 7-day limits and whether the prompt cache is warm or cold. Enable it with"statusLine": {"type": "command", "command": "~/.claude/system1-statusline.py", "refreshInterval": 15}in~/.claude/settings.json. - Easy to leave:
theme-switch offputs back the Hyprland theme, palette, mode, wallpapers, icon theme and idle timeout you had before.
- Hyprland 0.56 or newer with the Lua config (
~/.config/hypr/hyprland.lua) - Noctalia 5.4 or newer as the shell
- To build: a C compiler,
make,pkg-config,wayland-scanner, and the wayland-client, wayland-egl, EGL and GLESv2 headers - For the file icons: breeze icons (the fallback for anything System 1 doesn't
draw) and
kwriteconfig6(KConfig); qt6ct or qt5ct for non-KDE Qt apps rsvg-convert(librsvg), ImageMagick 7 (magick),curl, and Python 3 with Pillow and fontTools
On Arch-based systems:
sudo pacman -S --needed base-devel wayland mesa librsvg imagemagick python-pillow python-fonttools curl breeze-icons kconfig
Developed on CachyOS with an NVIDIA GPU, a 3440×1440 OLED and a portrait 1440p monitor.
git clone https://github.com/FUTC-Coding/SYSTEM-1 ~/Projects/system1
cd ~/Projects/system1
./install.sh --location "50.78 6.08" # your latitude and longitude
The installer links the checkout to ~/.config/system1, downloads the two
fonts (OFL) if you don't have them, builds the renderer, renders the
textures, pixel icons and file icon themes, and links the Hyprland files into
~/.config/hypr/themes/. If your hyprland.lua doesn't load the theme
loader yet, it tells you to add this line after your own look settings:
require("themes.loader")Then reload Hyprland and switch it on:
~/.config/system1/bin/theme-switch system1
Run ./install.sh again after a git pull or a Noctalia update.
The loader reads ~/.config/hypr/theme-name. For any name other than
system1 it loads ~/.config/hypr/themes/<name>/init.lua if that exists,
and otherwise loads nothing and leaves your config alone. So you can either
keep your decorations in hyprland.lua (the loader only adds System 1 on
top while it's active), or move them into themes/<name>/init.lua and put
that name in theme-name. theme-switch remembers which one was active and
restores it.
theme-switch system1 | off | toggle | status
| Keys | Does |
|---|---|
| SUPER+CTRL+T | switch System 1 on/off |
| SUPER+CTRL+S | screensaver now (any input closes it) |
| SUPER+CTRL+B | pause/resume the animated background |
| SUPER+CTRL+M | flip light/dark by hand (noctalia msg theme-mode-set auto follows the sun again) |
Switching restarts Noctalia for a second (it loads its icon font only at startup) and reloads Hyprland.
- Location:
./install.sh --location "LAT LON", or editlocation. - Logo: replace
logo/bird.svg(any SVG; its alpha is used) and runsrc/build-assets.sh. - Phrases: edit
PHRASESinsrc/build-assets.shand keepphraseLen()inshaders/background.fragin step with their lengths. - The scenes:
shaders/background.fragandshaders/saver.frag. Edit, thenpkill -HUP -fx ~/.config/system1/bin/system1-bgto reload them. - Frame rate:
SYSTEM1_FPS(default 15). The background costs a few watts of GPU on NVIDIA mostly by keeping the GPU awake, not by the shader. - Idle timers: the saver's timeout is in
noctalia/system1.toml, the screen-off timeout isSAVER_SCREEN_OFFinbin/theme-switch. - Colours:
noctalia/System1.json(Noctalia palette, dark and light) andPALETTEinhypr/system1.lua.
To get the bird when a terminal opens, call system1-fetch from your shell's
greeting. In fish, after anything else that defines fish_greeting:
function fish_greeting
~/.config/system1/bin/system1-fetch
endSYSTEM1_FETCH_ANIMATE=0 skips the animation, SYSTEM1_FETCH_DELAY sets the
seconds per frame (0.03) and SYSTEM1_FETCH_WIDTH the logo width in columns
(52) and SYSTEM1_FETCH_SHIFT nudges the bird on the half-block grid if
stray blocks show up (1); run src/build-assets.sh after changing either.
Those two only apply to a scaled-down logo: the futc bird is hand-drawn in
logo/bird-fetch.txt (# = ink), so edit that, or delete it after
replacing the logo.
| Path | What |
|---|---|
src/system1-bg.c |
wlr-layer-shell + GLES2 renderer, one surface per output: the background, the screensaver (--saver) and still renders (--snapshot W H dark|light HOUR out.ppm) |
shaders/ |
the animated background and the screensaver |
src/build-assets.sh |
bird, captions and clock digits as PGM textures in assets/ |
src/pixel-icons.py |
resamples Noctalia's Tabler icon font onto a 16×16 grid into noctalia/assets/ (used through NOCTALIA_ASSETS_DIR) |
src/build-icons.py |
draws the System1-Light / System1-Dark icon themes into icons/, linked into ~/.local/share/icons/ |
hypr/loader.lua |
picks the Hyprland theme, kanji workspace names, Noctalia assets dir |
hypr/system1.lua |
the Hyprland side of the theme |
noctalia/System1.json |
palette, linked into ~/.config/noctalia/palettes/ |
noctalia/system1.toml |
style overlay, linked into ~/.config/noctalia/ while active |
fontconfig/50-system1.conf |
lets Departure Mono fall back to DotGothic16 for kanji |
bin/theme-switch |
switches on and off, saving and restoring your settings |
bin/system1-mode |
Noctalia hook: spreads light/dark to Hyprland, the background and the stills |
bin/system1-fetch |
fastfetch with the animated half-block bird |
src/build-fetch.py |
the bird and its wipe frames as text, into assets/fetch/ |
bin/system1-wallpapers |
renders the still wallpapers for the lock screen (re-run after changing monitors) |
./install.sh --uninstall
Then remove require("themes.loader") from hyprland.lua.
The code is MIT licensed (see LICENSE). logo/bird.svg (and its pixel
version logo/bird-fetch.txt) is the futc.de
logo and is not covered by that licence.
- Fonts, downloaded at install: Departure Mono by Helena Zhang and DotGothic16, both SIL Open Font License.
- Icons: pixelated at install from Tabler Icons (MIT) as shipped with Noctalia.
src/wlr-layer-shell-unstable-v1.xmlandsrc/xdg-shell.xmlare the Wayland protocol definitions, under the licences in their headers.




