| .forgejo/workflows | ||
| .github/workflows | ||
| assets | ||
| cmd/dots | ||
| configs | ||
| docs | ||
| flatpaks | ||
| lib | ||
| optional | ||
| overlay | ||
| packages | ||
| portage | ||
| presets | ||
| tests | ||
| 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.
KDE styling · Shortcuts · Packages · Setup
Overview
A personal Gentoo rice and restoration kit: my Plasma styling, current shortcuts, package lists and the app preferences I use every day. Built mainly for my own devices, with deliberate updates and a preview before anything is applied.
- KDE first: colours, fonts, cursor, window styling and current keybinds.
- Pick what you want: package sections and individually optional app configs.
- Portable terminals: Fish, Kitty and Neovim work across compositors.
- Binaries preferred: a small source list, with a choice before extra builds.
- Keep your edits: conflict prompts, backups and
.newproposals on updates.
Work in progress: configuration restoration and the TUI are ready for review. Package and boot execution need a supervised first run on a fresh Gentoo system. The existing installation has not been changed by creating this repo.
Start
git clone --branch v0.1.2 https://git.fiwlabs.dev/fiwdev/Fiw-Gentoo-Dots.git
cd Fiw-Gentoo-Dots
./install
The Bubble Tea interface offers a preset, package sections, individual app
configs, kernel/bootloader choices, individual Flatpaks, optional services and
a final preview. Enter saves without applying. r runs the full restore;
a restores configs, i installs Portage packages, f installs Flatpaks,
v enables selected services and b deploys the selected bootloader.
e updates configs while preserving local edits; p opens pending changes
for a diff and individual acceptance. u opens config backups for preview
and restoration. n saves a named device selection, available
alongside Stock and Fiw's Ryzen on the preset screen. Apply actions finish
with a combined report of outcomes and remaining setup.
Linux amd64 includes a verified prebuilt TUI; Git and Python 3.11+ are enough.
Go 1.24+ is the source fallback for changed frontend code or other platforms.
Saved selections are reused on subsequent launches. See the
snapshot and build instructions.
Forgejo is the primary repository; GitHub receives branches and tags through the CI mirror workflow after the checks pass.
For a preview without building the TUI:
./install --plan --profile stock
./install --plan --profile fiw-ryzen
See setup for installation steps and draft limitations.
Presets
| Preset | Build settings | Kernel |
|---|---|---|
| Stock | Portable compiler settings; binary packages preferred | Generic Gentoo binary kernel |
| Fiw's Ryzen | Current Ryzen 9900X/Zen 5 tuning and NVIDIA configuration | Tested custom kernel plus generic binary fallback |
Both deliberately compile Fastfetch, jq and zip. Custom kernels and their
matching external modules compile when selected. Other packages prefer
Portage binaries or upstream -bin packages. Additional source builds
require a compile-or-skip choice, with compilation recommended; skipped
dependencies also cause dependent requested applications to be skipped.
The custom kernel snapshot currently targets 7.2.8 with the tested CachyOS 7.2.7-1 patch. Refresh it explicitly when updating the snapshot.
Package sections
| List | Contents |
|---|---|
| kde | Plasma, Plasma Login Manager, desktop components and supporting fonts |
| fiw-apps | Everyday apps including Dolphin, Ark, Gwenview and Spectacle |
| cli | Shell, terminal utilities and FFmpeg |
| dev | Languages and development tools |
| gaming | Steam, Proton, Prism, MangoHud and r2modman; Sober is in flatpaks/gaming.list |
| system | System utilities; the selected kernels are added by the installer |
| fiw-tools | FiwNode binary release, Apdatifier Gentoo, OpenDeck and Music Presence |
| tidewm | Optional compositor and supporting utilities |
Filelight, NVIDIA drivers and Btrfs tools are separate extras. Ext4 does not require Btrfs tools. LocalSend and Sober are individually optional Flatpaks in the TUI, grouped with apps and gaming respectively. Limine and GRUB are optional alternatives; retaining the current loader is the default. Kernel choice is independent of bootloader choice. Deployment previews the target ESP and firmware choices; see boot setup. The package audit accounts for all current explicit selections. TideWM remains an optional source build.
Configs
Every config is independently selectable, even when its package section is unchecked—for example, to configure apps already installed. KDE appearance covers colours, fonts, cursor and window decorations, with matching GTK preferences. Dolphin styling has its own checkbox. Panels, widgets and wallpapers are excluded. All portable current shortcut assignments, including disabled defaults, are captured with their launchers and helpers; unused machine-specific activity IDs are omitted.
Fish, Kitty and Neovim are usable without KDE or KWin. Fastfetch keeps the tree layout and purple colours with the built-in Gentoo logo. MangoHud and Vesktop preferences are included; browser profiles, chat sessions and account data are excluded. App autostart is a separate optional selection. Neovim's Catppuccin and VS Code's ayu MiDas themes are bundled with their respective optional configs, so their styling is available on fresh devices. Ark, Gwenview and Prism preferences are individually optional too; see app configs and requirements. Each config's required packages appear in the final preview without changing package selections.
Spotify is stock by default. The existing customization scripts remain an explicit optional step. Firefox-Privacy is also optional.
Existing differences prompt apply-or-keep and get backups when replaced.
Updates leave locally edited configs intact and write the proposal to .new.
The TUI can review and accept each proposal, backing up the
current file and refusing proposals whose target changed since creation.
KConfig patches preserve unrelated keys and groups; JSON patches preserve
unrelated preferences and login data already on the target device.
The TUI can restore user config backups, with a preview,
confirmation and a new backup of the replaced current files.
Project layout
cmd/dots/ Bubble Tea selection interface
configs/ Optional KDE and app configs
packages/ Categorized Portage package lists
presets/ Stock and Fiw's Ryzen defaults
portage/ Build settings and binary preferences
overlay/ Selected additional packages
optional/ Kernel, boot and app helpers
flatpaks/ Separate optional Flatpak lists
docs/ Setup, decisions and asset credits
Maintenance
python3 tools/capture.py # recapture only the explicit allowlist
python3 tools/capture.py --config kde-shortcuts # refresh only shortcuts
python3 tools/capture.py --config kitty neovim # refresh only these apps
python3 tools/check-private.py
python3 -m unittest discover -s tests
go test ./...
Missing selected overlays are staged before package resolution. Optional service presets enable audio, networking, Bluetooth and power profiles for the next boot/login. See setup and the helper list.
Review captures before committing. local/ and built binaries are ignored.
See selective recapture for supported selections and pinned assets.
This repo starts with fresh history. Third-party theme/cursor assets retain
their licence notices; overlay ebuilds retain their original notices.
License
Original code and configuration contributions are licensed under MIT. Bundled third-party assets, fonts, patches and ebuilds keep their own licences and attribution; see asset credits.