Welcome
bromigOS is a desktop for Linux, based on Arch Linux. It gives you:
- a desktop where the windows tile themselves, and every action has a key;
- an animated background that shows what your machine is doing;
- panels with live readings: processor, network, disks, your notes;
- themes that recolour every app at once, and two worlds, living scenes that react to your work;
- VECTOR, an AI assistant you can talk to, who runs your tools and makes images and 3D holograms;
- your homelab on the desktop, if you run one, with AI work sent to its graphics cards instead of a paid service.
This manual shows you how to use it. It’s for people who have installed bromigOS, or are
about to. How bromigOS is built is in the developer docs, in the repository’s docs/
folder.
Start here
- Install bromigOS.
- Answer the first-run questions.
- Learn the first few keys. They get you everywhere.
- Try a few common tasks.
Find your way
| To | Read |
|---|---|
| find your way around the screen | Getting around |
| do something specific, step by step | Common tasks |
| change how it looks | Themes and worlds |
| change a setting | Settings |
| talk to VECTOR | VECTOR |
| look up a key or a command | Keys, Commands |
| look up a word | Glossary |
| fix a problem | Troubleshooting |
Help on the desktop
- Press Super+K to see every key on the desktop.
- Hover over anything on the bar, the panels or in Settings. It says what it is and what it does.
- In Settings, press F1 to open this manual on the page you’re looking at.
- In a terminal, add
--helpto anybromigoscommand.
The story
bromigOS has a story behind its look. The default theme, the Wick, is a relay station at the edge of a stretch of space called the Drift, kept lit by whoever is on shift. That’s you. VECTOR keeps the line open. The story gives names to some parts of the desktop. The glossary explains each one.