Fiw-Gentoo-Dots/docs/app-configs.md

2.8 KiB

Optional app preferences

Each preset has its own checkbox. Configs can be restored for already installed apps without selecting a package section. Close the affected app before restoring its preferences so it reads the new settings on its next launch.

Additional captured apps

Preset Captured preferences Target file
Ark Open the destination after extraction; visible, locked sidebar; hidden status bar .config/arkrc
Gwenview Hidden menu bar and information sidebar splitter proportions .config/gwenviewrc
Prism Breeze appearance, dark Breeze icons, console font/limits, console visibility and launcher/game-time behaviour .local/share/PrismLauncher/prismlauncher.cfg

These use key-by-key merges. Existing recent files, accounts, Minecraft instances, machine paths, Java selection, memory limits and unrelated preferences stay on the target. The Prism path is for the native Gentoo package. Its Minecraft and Java setup is listed in the final manual steps.

Ark, Gwenview and Prism are selected in both shipped presets and can be unchecked independently. Recapture only these allowlisted keys with:

python3 tools/capture.py --apps-only

Config requirements

The final preview lists the packages needed for each selected config:

Status Meaning
installed Portage confirms the package is present on this device
selected The package is directly included in the selected package plan
missing The package is absent and is not directly selected
unverified Portage is unavailable, so installation cannot be checked

Some requirements arrive as dependencies, such as Plasma components through plasma-meta. Their preview status can be missing until Portage resolves and installs them. Requirements do not automatically check package groups or block config-only restoration. The combined report checks actual installed packages again, including requirements of apps whose installation was skipped.

Fish, Kitty, Neovim and Fastfetch have no Plasma or KWin requirements. Fonts have their own checkbox; Kitty can use its fallback font if those are omitted. The original Neovim config uses a built-in fallback when Catppuccin is absent.

r2modman

Set its appearance through the app's settings. Global and game settings use a shared IndexedDB store, as shown in the upstream settings implementation. There is no captured r2modman config preset; its Electron profile and databases remain local. Restore wanted mod profiles through the app's profile export/import workflow. Selected gaming installs include this reminder in their combined report.