A clean, customizable Wayland workstation.
Built on Debian 13 and Hyprland. Cohesive out of the box, configured in readable plain text, and engineered for focused daily development.
_____ _ _
| ___| |_ _ ___ _ __(_)_ __
| |_ | | | | |/ _ \| '__| | '_ \
| _| | | |_| | (_) | | | | | | |
|_| |_|\__,_|\___/|_| |_|_| |_|
___ ____
/ _ \/ ___|
| | | \___ \
| |_| |___) |
\___/|____/Design & Architecture
Engineered for focus and predictability
FluorineOS avoids complex abstractions. Everything in the user space is inspectable, editable, and backed by Debian package management.
Cohesive Out of the Box
Unified Hyprland environment with preconfigured Waybar, Fuzzel, SwayNC, Kitty, and boot splash ready on first boot.
Plain-Text Customization
Every visual rule, animation curve, and keybinding lives in clean Lua, CSS, and INI files inside ~/.config/.
Debian 13 Foundation
Built on Debian Trixie (x86_64) with Hyprland pinned from trixie-backports, PipeWire audio, zstd ZRAM, and an active ufw firewall.
Keyboard-Driven Flow
Fast console login via greetd and tuigreet, predictable tiling layouts, and built-in CLI utilities (flr-shot, flr-keys, flr-doctor).
Workflow Reference
Default Keybindings
Configured in ~/.config/hypr/hyprland.lua via native Lua binds.
| Shortcut Chord | Action Description |
|---|---|
SUPER+Return | Launch Kitty terminal emulator |
SUPER+D | Launch Fuzzel application launcher |
SUPER+E | Launch Thunar file manager |
SUPER+Q | Close active focused window |
SUPER+V | Toggle active window floating state |
SUPER+F | Toggle active window fullscreen mode |
SUPER+Shift+S | Interactive screenshot selection (flr-shot) |
SUPER+/ | Display interactive keybinding cheat sheet (flr-keys) |
SUPER+L | Lock workstation session immediately (hyprlock) |
SUPER+1..9 | Switch to workspace 1 through 9 |
SUPER+Shift+1..9 | Move active window to workspace 1 through 9 |
Specifications & Deployment
System Architecture & Installation
FluorineOS targets standard x86_64 PC hardware with UEFI firmware. Verified on physical workstations and virtualization hosts.
Hardware Requirements
| Component | Minimum | Recommended |
|---|---|---|
| Architecture | x86_64 (amd64) | x86_64 (amd64) |
| Memory (RAM) | 4 GB | 8 GB or more |
| Storage | 20 GB free | 50 GB NVMe / SSD |
| Firmware | UEFI x64 | UEFI x64 |
| Graphics | KMS / DRM GPU | Intel, AMD, or Nouveau |
Core System Components
- Base Distribution
- Debian 13 (trixie)
- Wayland Compositor
- Hyprland 0.55+ (Lua config)
- Display Manager
- greetd + tuigreet
- Audio Server
- PipeWire + WirePlumber
- Swap Compression
- ZRAM with zstd algorithm
- Host Firewall
- ufw active by default
sha256sum -c FluorineOS-0.0.1-amd64.iso.sha256sudo dd if=FluorineOS-0.0.1-amd64.iso of=/dev/sdX bs=4M status=progress oflag=sync# Install archive signing key
curl -fsSL https://fluorineos.github.io/apt-repo/fluorineos-archive-keyring.gpg | sudo tee /usr/share/keyrings/fluorineos-archive-keyring.gpg > /dev/null
# Configure deb822 source
sudo tee /etc/apt/sources.list.d/fluorineos.sources << 'EOF'
Types: deb
URIs: https://fluorineos.github.io/apt-repo
Suites: trixie
Components: main
Architectures: amd64
Signed-By: /usr/share/keyrings/fluorineos-archive-keyring.gpg
EOF
# Refresh package index and install desktop stack
sudo apt-get update && sudo apt-get install -y fluorine-desktopEcosystem
Organization Repositories
FluorineOS is developed as a collection of modular repositories under the FluorineOS GitHub organization.
Primary ISO assembly tree, live-build hooks, Calamares overrides, and build automation.
Hyprland 0.55 Lua configuration, Waybar, Kitty, Fuzzel, SwayNC, and flr-* CLI utilities.
3840x2160 AMOLED SVG wallpapers, Plymouth boot splash, fastfetch branding, and assets.
Archive signing key and deb822 sources configuration for APT repository verification.
Signed reprepro Debian package archive published through GitHub Pages.