Hornero OS documentation
Find a guide by the task you are trying to complete. This repository is the user and contributor handbook; implementation contracts stay with the Shell, CLI, and configuration repositories.
Hornero OS is an Arch-based desktop project in development. There is no installable ISO or supported system installer yet. The release page and installation status are the current source for what can be installed.
Choose a path
| If you want to… | Start here |
|---|---|
| Understand release and installation status | Getting started |
| Use the desktop, apps, and Control Center | Desktop · Apps and workflows |
| Change themes, colors, or wallpaper | Appearance · Wallpapers |
| Choose a bar arrangement | Layouts |
| Find a keyboard shortcut | Shortcuts |
| Automate or inspect the system from a terminal | horneroctl |
| Diagnose graphics or device problems | Hardware · Troubleshooting |
| Understand system boundaries | Architecture |
| Build, test, or contribute | Development |
How these docs stay accurate
Steps describe behavior available in the released product unless they are
labelled Development or Preview. Package, installer, and release
availability can change; check the live release and installation pages before
following older notes. Commands are taken from horneroctl help and current
product configuration. Personal machine examples from the former dotfiles
wiki are not system requirements.
The website imports these Markdown pages at a reviewed commit and adds its own navigation, search, and responsive presentation. This repository owns the content; the website does not maintain a second copy.
Areas
- Getting started — release status and a safe first look.
- Desktop — appearance, wallpaper, layouts, and shortcuts.
- Apps and workflows — the configured application catalog and the paths that connect those tools to Hornero.
- horneroctl — supported command-line entry points.
- Hardware — device diagnostics and graphics guidance.
- Troubleshooting — recover from common failures.
- Architecture — ownership and data flow.
- Development — code, QA, and contribution paths.
License
MIT.