Release 0.0.1 - Debian 13 (Trixie) + Hyprland 0.55+

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.

1234
78%
100%
14:45
  _____ _                _
 |  ___| |_   _  ___  _ __(_)_ __
 | |_  | | | | |/ _ \| '__| | '_ \
 |  _| | | |_| | (_) | |  | | | | |
 |_|   |_|\__,_|\___/|_|  |_|_| |_|

       ___  ____
      / _ \/ ___|
     | | | \___ \
     | |_| |___) |
      \___/|____/
user@fluorine ----------------------
OS: FluorineOS 0.0.1 x86_64
Base: Debian GNU/Linux 13 (trixie)
Kernel: Linux 6.12.9-amd64
Uptime: 2 hours, 14 mins
Packages: 1420 (dpkg)
Shell: bash 5.2.37
Display: 3840x2160 @ 144Hz
WM: Hyprland 0.55.0 (Wayland)
Theme: AMOLED Void (#000000 / #B4F03A)
Terminal: kitty 0.38.0
Login: greetd + tuigreet
Audio: PipeWire 1.2.7 (WirePlumber)
Memory: 1.84 GiB / 31.25 GiB (ZRAM zstd active)

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.

Hyprland 0.55+

Cohesive Out of the Box

Unified Hyprland environment with preconfigured Waybar, Fuzzel, SwayNC, Kitty, and boot splash ready on first boot.

Lua & CSS

Plain-Text Customization

Every visual rule, animation curve, and keybinding lives in clean Lua, CSS, and INI files inside ~/.config/.

Debian Trixie

Debian 13 Foundation

Built on Debian Trixie (x86_64) with Hyprland pinned from trixie-backports, PipeWire audio, zstd ZRAM, and an active ufw firewall.

CLI & Keybinds

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 ChordAction 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

ComponentMinimumRecommended
Architecturex86_64 (amd64)x86_64 (amd64)
Memory (RAM)4 GB8 GB or more
Storage20 GB free50 GB NVMe / SSD
FirmwareUEFI x64UEFI x64
GraphicsKMS / DRM GPUIntel, 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
1. Verify ISO Checksum
sha256sum -c FluorineOS-0.0.1-amd64.iso.sha256
2. Flash to Removable Media (USB)
sudo dd if=FluorineOS-0.0.1-amd64.iso of=/dev/sdX bs=4M status=progress oflag=sync
3. Add APT Repository on Debian 13
# 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-desktop

Ecosystem

Organization Repositories

FluorineOS is developed as a collection of modular repositories under the FluorineOS GitHub organization.