| .forgejo/workflows | ||
| .github/workflows | ||
| assets | ||
| cmd/dots | ||
| configs | ||
| docs | ||
| flatpaks | ||
| lib | ||
| optional | ||
| overlay | ||
| packages | ||
| portage | ||
| presets | ||
| tools | ||
| .gitignore | ||
| go.mod | ||
| go.sum | ||
| install | ||
| LICENSE | ||
| README.md | ||
| VERSION | ||
Fiw-Gentoo-Dots
My Gentoo setup, ready to make home feel like home again.
About
My personal Gentoo restoration kit, mainly for my own devices:
- KDE colours, fonts, cursor, window styling and my exact keybinds.
- Separate package lists and individually optional app configs.
- Fish, Kitty and Neovim preferences that work across compositors.
- Binaries preferred, with a small deliberate source-build list.
- A Bubble Tea chooser with a final preview, conflict prompts and backups.
Stock and Fiw's Ryzen have been installed and checked in Gentoo QEMU/KVM. The full TUI restore, KDE presets, optional apps, GRUB/Limine and ext4/Btrfs booting passed. See tested scope and hardware limits.
Screenshots
Desktop
My running desktop. Wallpapers and panels stay local; the saved Fastfetch preset uses the built-in Gentoo logo.
Installer
Start
git clone https://git.fiwlabs.dev/fiwdev/Fiw-Gentoo-Dots.git
cd Fiw-Gentoo-Dots
./install
Start from an installed Gentoo system. Linux amd64 includes a prebuilt TUI; Git and Python 3.11+ are enough. Go 1.24+ is needed only for source builds. Choose your packages/configs, review the plan, then select an action. Enter saves your choices without applying them.
See setup and TUI keys, tagged snapshots, saved devices, config updates and backup restoration.
Presets
| Preset | Build settings | Kernel |
|---|---|---|
| Stock | Portable settings, binaries preferred | Generic Gentoo binary kernel |
| Fiw's Ryzen | Ryzen 9900X / Zen 5 tuning and NVIDIA | Custom kernel + binary fallback |
Both compile Fastfetch, jq and zip. Selected custom kernels and modules also compile. Other source builds require a compile-or-skip choice; missing/skipped packages appear in the final report.
Packages
| List | Contents |
|---|---|
| kde | Plasma, Plasma Login Manager and desktop components |
| fiw-apps | Everyday apps, including Dolphin, Ark, Gwenview and Spectacle |
| cli | Shell and terminal utilities |
| dev | Languages and development tools |
| gaming | Steam, Proton, Prism, MangoHud and r2modman |
| system | System utilities; kernels follow your selection |
| fiw-tools | FiwNode, Apdatifier Gentoo, OpenDeck and Music Presence |
| tidewm | Optional compositor and supporting tools |
Filelight, NVIDIA and Btrfs tools are separate extras. Sober and LocalSend are individually optional Flatpaks. Limine and GRUB are optional; keeping the existing bootloader is the default. See boot setup.
Configs
Every app config is independently optional. KDE styling includes matching GTK preferences; autostart has its own checkbox. Neovim's Catppuccin theme, VS Code's ayu MiDas theme, fonts and cursor assets are bundled with their licences. Accounts and sessions stay local.
Local edits are preserved on updates, with proposed changes saved as .new
for review. Replaced files get backups. Spotify stays stock;
customization and Firefox-Privacy are
explicit optional steps.
Maintenance
python3 tools/capture.py --config kde-shortcuts
python3 tools/capture.py --config kitty neovim
python3 tools/check-private.py
Review git diff before committing. See capture options
and helper commands. Device choices and local files are
gitignored. Forgejo is primary; GitHub
receives branches and tags automatically after CI checks.
License
Original code and configs: MIT. Bundled third-party assets keep their own licences; see credits.