Difference between revisions of "Plasma-Manager"
(DRAFT) |
(DRAFT) |
||
| Line 1: | Line 1: | ||
Plasma-Manager lets your write down your KDE settings. It mimics the style and syntax of configuration.nix. If you have more than a handful of computers it can help you set them up consistently. It's also useful if you reinstall your OS or change PC's. | Plasma-Manager lets your write down your KDE settings. It mimics the style and syntax of configuration.nix. If you have more than a handful of computers it can help you set them up consistently. It's also useful if you reinstall your OS or change PC's. | ||
| − | Plasma-Manager is an add-in for Home Manager. Home Manager is like [https://www.chezmoi.io/ Chezmoi] or [https://tamerlan.dev/how-i-manage-my-dotfiles-using-gnu-stow/ GNU Stow]. It lets you write down and version control your dotfiles. It also lets you install packages for yourself rather than system-wide. You do not need to be proficient with Home Manager to use Plasma Manager. Also, you do not need to replace Chzemoi/Stow if you use it. (The author personally uses Chezmoi for dotfiles and Plasma-Manager for KDE.) | + | Plasma-Manager is an add-in for Home Manager. Home Manager is like [https://www.chezmoi.io/ Chezmoi] or [https://tamerlan.dev/how-i-manage-my-dotfiles-using-gnu-stow/ GNU Stow]. It lets you write down and version control your dotfiles. It also lets you install packages for yourself rather than system-wide. You do not need to be proficient with Home Manager to use Plasma-Manager. Also, you do not need to replace Chzemoi/Stow if you use it. (The author personally uses Chezmoi for dotfiles and Plasma-Manager for KDE.) |
== How to setup Standalone Home Manager == | == How to setup Standalone Home Manager == | ||
| Line 7: | Line 7: | ||
In this context the term Standalone means you are installing it in your home directory. You do not need to change your configuration.nix. Also, you do not need to be a member of the wheel group nor do you need sudo. | In this context the term Standalone means you are installing it in your home directory. You do not need to change your configuration.nix. Also, you do not need to be a member of the wheel group nor do you need sudo. | ||
| − | + | '''1) Add Channels as Your User''' | |
| − | + | ||
| − | + | Set the release URL to match your installed NixOS. It doesn't matter if you use Channels or Flakes to manage the OS. | |
| − | + | ||
| − | + | <syntaxHighlight lang=shell> | |
| − | + | nix-channel --add https://github.com/nix-community/home-manager/archive/release-25.05.tar.gz home-manager | |
| − | + | nix-channel --add https://github.com/nix-community/plasma-manager/archive/trunk.tar.gz plasma-manager | |
| − | + | nix-channel --update | |
| − | + | </syntaxHighlight> | |
| − | + | ||
| − | + | '''2) Install Standalone Home Manager''' | |
| − | + | ||
| + | <syntaxHighlight lang=shell> | ||
| + | nix-shell '<home-manager>' -A install | ||
| + | </syntaxHighlight> | ||
| + | |||
| + | '''3) Edit this file to suit your needs''' | ||
| + | |||
| + | '''4) Apply the Changes''' | ||
| + | |||
| + | <syntaxHighlight lang=shell> | ||
| + | home-manager switch | ||
| + | </syntaxHighlight> | ||
| + | |||
| + | '''5) Verify and Customize''' | ||
| + | |||
# - Import existing settings | # - Import existing settings | ||
# 1) `nix run github:nix-community/plasma-manager/trunk#rc2nix > plasma.nix` | # 1) `nix run github:nix-community/plasma-manager/trunk#rc2nix > plasma.nix` | ||
Revision as of 13:47, 29 August 2025
Plasma-Manager lets your write down your KDE settings. It mimics the style and syntax of configuration.nix. If you have more than a handful of computers it can help you set them up consistently. It's also useful if you reinstall your OS or change PC's.
Plasma-Manager is an add-in for Home Manager. Home Manager is like Chezmoi or GNU Stow. It lets you write down and version control your dotfiles. It also lets you install packages for yourself rather than system-wide. You do not need to be proficient with Home Manager to use Plasma-Manager. Also, you do not need to replace Chzemoi/Stow if you use it. (The author personally uses Chezmoi for dotfiles and Plasma-Manager for KDE.)
How to setup Standalone Home Manager
In this context the term Standalone means you are installing it in your home directory. You do not need to change your configuration.nix. Also, you do not need to be a member of the wheel group nor do you need sudo.
1) Add Channels as Your User
Set the release URL to match your installed NixOS. It doesn't matter if you use Channels or Flakes to manage the OS.
nix-channel --add https://github.com/nix-community/home-manager/archive/release-25.05.tar.gz home-manager
nix-channel --add https://github.com/nix-community/plasma-manager/archive/trunk.tar.gz plasma-manager
nix-channel --update
2) Install Standalone Home Manager
nix-shell '<home-manager>' -A install
3) Edit this file to suit your needs
4) Apply the Changes
home-manager switch
5) Verify and Customize
- - Import existing settings
- 1) `nix run github:nix-community/plasma-manager/trunk#rc2nix > plasma.nix`
- 2) Manually merge the output into your home.nix
- - How to troubleshoot
- 1) Review the output of `home-manager switch`
- 2) Check logs: `journalctl --user -u home-manager.service`
- References
- - Plasma options: https://nix-community.github.io/plasma-manager/options.xhtml
- - Examples: https://github.com/search?q=programs.plasma+language%3Anix&type=code