Control panel · media, volume/mic/brightness, quick toggles, capture, session |
System · cpu, memory, disks, battery, power profile, GPU mode (envycontrol) |
Runner (Super+R) · apps, scripts, calc, shell; also a dmenu for scripts |
Wallpaper picker · live full-screen preview, folders, search, vim keys, three looks; re-themes everything through matugen |
Glyph picker (Super+`) · emoji, nerd icons, symbols, kaomoji, fancy text |
Power menu (Super+Esc) · lock, logout, suspend, reboot, ... |
Calendar · from the clock in the bar |
Settings (Super+I) · searchable (Ctrl+F); network, sound, look, Hyprland, keybinds, display, power |
Overview · live previews of every workspace and window, click to jump |
> [!WARNING]
> **This is my personal setup, not a general purpose desktop or dotfiles framework.**
>
> It's built around my hardware (Lenovo Legion, Intel + NVIDIA hybrid graphics, `linux-zen`), my monitors,
> my keyboard and my habits. I'm not trying to make it work for everyone, and I won't be adding options
> or support for other setups. It's public as a **reference**, or for people who want **exactly the same
> setup** as me.
>
> **From the Arch ISO, `install.sh` erases the disk you pick.** On an installed system, only run it on a
> freshly installed, unconfigured Arch Linux: it installs a lot of packages (NVIDIA drivers included if you pick
> them), replaces your configs with symlinks, changes your login shell and can enable system services.
> Don't run it on a system you already use.
## Installing
### From the Arch ISO (everything)
Boot the [Arch ISO](https://archlinux.org/download/) in UEFI mode, get online (`iwctl` for Wi-Fi), then:
```bash
bash <(curl -fsSL https://git.krolyxon.com/aurora/raw/master/install.sh)
```
It asks everything first, shows a summary and only starts after you type the disk's name. Then it runs on its own:
- disk: **auto** erases a whole disk (1 GiB EFI at `/boot` + the rest), **manual** runs cfdisk and lets you pick
the partitions (an existing EFI partition is kept unformatted for dual boot)
- optional LUKS2 encryption, ext4, zram instead of a swap partition
- `packages/base.txt` + CPU microcode, `linux-zen` (default) and `linux` (fallback), GRUB
- your user with sudo, timezone/locale/keymap, NetworkManager (Wi-Fi joined with `iwctl` carries over)
- the desktop part below, inside the new system, so you reboot straight into Hyprland + aurora (log in on tty1)
`./install.sh --base` does only the base system. The log ends up in `/var/log/aurora-install.log`.
### On an installed Arch (desktop only)
```bash
git clone https://git.krolyxon.com/aurora ~/aurora
cd ~/aurora
./install.sh # interactive: pick packages per group (same as --desktop)
./install.sh --yes # pre-select the default packages, no questions
./install.sh --check # only compare installed packages with the lists, changes nothing
```
Clone it anywhere (e.g. `~/dev/aurora`): the repo's `.stowrc` points stow at `$HOME`. Re-stow by hand with `stow .`
from the repo; to move an existing checkout, `stow -D .` first, move it, then `stow .` again.
## Packages
The lists live in `packages/*.txt`: one package per line, `#` for comments, and a trailing `!` means
"listed, but not pre-selected".
| file | |
|---|---|
| `desktop.txt` | always installed: Hyprland, Quickshell, PipeWire, the tools the shell and keybinds call |
| `utils.txt` | CLI tools, fonts, media, small utilities |
| `dev.txt` | development tools |
| `gpu.txt` | Intel + NVIDIA (`nvidia-open-dkms`) drivers. Change this for your hardware |
| `optional.txt` | desktop apps |
| `aur.txt` | AUR packages (installed with paru) |
| `base.txt` | the base system: what the install from the ISO pacstraps |
## What's inside
| | |
|---|---|
| WM | Hyprland (Lua config), hypridle, hyprlock; aurora draws the wallpaper (mono dots, colour dots or photo) |
| Shell / bar | aurora (Quickshell) |
| Theming | matugen: picking a wallpaper in aurora (or `setwall`) re-themes everything (GTK via adw-gtk3, Qt via qt6ct); accent = the wallpaper's own colour, near-black surfaces. The terminal (foot) too, with ANSI colours tinted toward the wallpaper |
| Terminal / shell | foot, zsh |
| Editor | Neovim (LazyVim) |
| Launcher / menus | aurora's runner (`aurora-run`, also a dmenu replacement for scripts) |
| Files | lf, pcmanfm |
| Music / video | mpd + rmptui , mpv |
| Font / icons | Doto, Space Grotesk, Space Mono (shell UI, vendored in `.local/share/fonts/glyph`), JetBrainsMono Nerd Font, Papirus-Dark |
## Credits
- The dot-matrix shaders and some components started out as ports from
[glyph-rice](https://github.com/Nebelung-cloud/glyph-rice) (GPL-3.0); those files say so in their header.
- Nothing, Nothing OS and Glyph are trademarks of Nothing Technology Ltd; this is a fan project, not affiliated with Nothing.
- Fonts in `.local/share/fonts/glyph/`: [Doto](https://github.com/oliverlalan/Doto),
[Space Grotesk](https://github.com/floriankarsten/space-grotesk) and [Space Mono](https://github.com/googlefonts/spacemono),
under the SIL Open Font License (`OFL.txt` next to them).
