Yino - Functional Specification Document

Document Information

Field	Value
Version	1.0
Status	Draft
Created	2026-02-15
Updated	2026-02-15

1. Purpose

This document specifies the functional requirements for Yino (a recursive acronym for "Yino Is Not Omarchy") an opinionated set of configuration files for a desktop operating system based on Debian Linux. It is exactly like Omarchy but uses Debian Linux as a stable base instead of Arch Linux.

2. Goals

Produce a feature complete copy of Omarchy based on Debian Linux instead of Arch Linux
Replace all Arch specific tooling with Debian compatible counterparts where necessary / required
Remove anything that can be removed that has been added to Omarchy in order to deal with its possibly unstable, rolling release base of Arch Linux
Just like Omarchy, produce an ISO image that can perform a complete offline installation of Yino

3. Architecture

This should match Omarchy's architecture

Debian Linux as a base
Btrfs filesystem
Full disk encryption
Single user automatic sign in: encrypted disk unlock authenticates user, no further authentication is required except for unlocking the session and super user commands (sudo)
Wayland only
Latest Hyprland version as compositor and desktop environment
Target architecture is amd64, reference hardware will be Framework 13 AMD Ryzen™ 7040 laptop

4. Design principles

Version control (git) must be used
Less is more, minimize dependencies, avoid pulling in extra dependencies, always talk through with owner first
Keep it simple, KISS principle applies
Keep a changelog in this functional specification document

5. Development environment

QEMU should be used for testing and demo virtual machines
Keep a cache of downloaded assets (e.g. Debian installation ISO) in this repository's download directory

2.0 KiB Raw Blame History