README.org

NixOS Configuration

This repository lives on https://git.zweili.org/. Due to agressive LLM crawlers I had to make it private there. If you want to collaborate you can contact me through email or Mastodon.

This repository contains my configuration for my Nixos systems. I don’t provide any garantuees that it will work on other systems. In addition some of the scripts required for installation will destroy your data when used.

Desktop Profile Tools

Custom Scripts

Tool	Description
az-media	Open four shuffled mpv instances for ambient playback
dap-sync	Synchronise files with a DAP device
download-articles	Download web articles for offline reading
download-playlist	Download playlists via yt-dlp
download-video	Download a single video via yt-dlp
jdownloader	Launch JDownloader 2 download manager
sidecar-cleanup	Remove sidecar files left by photo tools
swiss-qr-bill-decoder	Decode a Swiss QR bill (image/PDF) to clipboard
toggle-keyboard	Toggle an external keyboard on/off via evtest
video-to-mpv	Convert videos to an mpv-compatible format
watch-playlist	Play a playlist with the custom mpv build
watch-random-video	Play a random video from a directory
watch-video	Play a video with the custom mpv build
zapp	Flash ZSA keyboard firmware

Photography

Tool	Description
darktable	RAW image processor with custom Lua automation
digikam	Photo organiser and image viewer
hugin	Panoramic image stitcher
rapid-photo-downloader	Import photos from cameras and memory cards

Media & Entertainment

Tool	Description
beets	Music library organiser and tagger
calibre	Ebook library manager
lollypop	Music player
mpv	Video player with custom shuffle and rotation support
plex-desktop	Plex media player client

Office & Productivity

Tool	Description
espanso	Text expander with date/time shortcuts
libreoffice	Office suite (documents, spreadsheets, presentations)
zotero	Citation and bibliography manager

Communication

Tool	Description
signal-desktop	Encrypted private messaging
telegram-desktop	Messaging platform

Utilities

Tool	Description
czkawka	Duplicate and similar file finder
exercism	Programming exercise platform CLI
keepassxc	Password manager
meld	Visual diff and merge tool
pdfgrep	Search text inside PDF files
remmina	Remote desktop client (RDP, VNC, SSH)
syncthingtray	System tray interface for Syncthing file sync
tagger	Audio file tag editor

Development

Tool	Description
dbeaver-bin	Universal database GUI client
emacs	Extensible text editor (Wayland/pgtk build)
gh	GitHub CLI
git	Version control system
nix-prefetch-github	Fetch Nix hash for a GitHub source
nix-prefetch-scripts	Fetch Nix hashes for various source types
nix-tree	Visualise Nix package dependency trees
nps	Run npm scripts interactively
termscp	Terminal SCP/SFTP client
trippy	Network diagnostic tool (traceroute + ping)

Installation

x86_64-linux without disko

1. Boot the installation ISO.
2. Format the disk with the following script sudo ./scripts/format-disk.sh. Make sure to edit it beforehand, to point it to the correct disk.
3. Next install the system with sudo nixos-install --no-root-passwd --root /mnt/nixos --impure --flake .#SYSTEMNAME --no-channel-copy
4. Rename the partitions with the script sudo ./scripts/rename-partitions.sh. With this script as well. Check that you’re pointing to the correct disk.

When everything is finished you can reboot the system and remove the USB stick. You have now a fully encrypted NixOS system.

Additional script

• If you only want to prepare an SD card with an UEFI partition for a Raspberry Pi 4 you can use the script sudo ./scripts/create-uefi.sh. This is currently outdated and not needed for SD cards formatted with disko. But it might be needed for systems that don’t have the UEFI parition on the same device.

Non-Nixos System

./scripts/install-home-manager.sh