Skip to content

Commit 53e7d64

Browse files
committed
more edits
1 parent 2b04e04 commit 53e7d64

File tree

1 file changed

+40
-14
lines changed
  • docs/user-docs/desktop-customization

1 file changed

+40
-14
lines changed

docs/user-docs/desktop-customization/index.md

Lines changed: 40 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,16 @@ To begin customizing your desktop, you need to create a file named `.desktoprc`
1010
in your remote directory. This is a bash script which will be sourced each time
1111
you log into any OCF desktop.
1212

13+
Lines that start with `$` are commands to enter into a terminal emulator such as `kitty` or `Konsole`.
14+
1315
>`~/remote` is an sshfs mount from `tsunami`, the OCF's public login server
1416
1517
To create a `.desktoprc` file, open a text editor of your choice and create a new file at `~/remote/.desktoprc`.
1618

1719
For example, here's how to do it with the Konsole terminal and Kate text editor:
1820

1921
1. Press Ctrl+Alt+T
20-
2. Run `kate ~/remote/.desktoprc`
22+
2. Run `$ kate ~/remote/.desktoprc` in a terminal such as `kitty`.
2123
3. Paste the following line: `nix run home-manager -- switch --flake ~/remote/home-manager`
2224
4. Ctrl+S to save
2325

@@ -26,13 +28,13 @@ Now, after logging in, the computer will switch to the flake within that directo
2628
## Home Manager Flake
2729

2830
We will first create a directory on `~/remote` that will set up NixOS
29-
Home Manager via a Nix Flake.
31+
Home Manager via a Nix Flake. Run these commands in a terminal such as `kitty`.
3032

31-
`mkdir ~/remote/home-manager`
33+
`$ mkdir ~/remote/home-manager`
3234

3335
Now, we will generate basic `flake.nix` and `home.nix` files in that directory we just made with the next command.
3436

35-
`nix run home-manager/master -- init ~/remote/home-manager`
37+
`$ nix run home-manager/master -- init ~/remote/home-manager`
3638

3739
## Plasma Manager
3840

@@ -82,23 +84,47 @@ Then, re-apply the flake with `nix run home-manager -- switch --flake ~/remote/h
8284

8385
If you're having trouble understanding Nix syntax, check out the Nix documentation on [Names and Values](https://nix.dev/tutorials/nix-language.html#names-and-values).
8486

85-
## System light/dark mode
87+
### System light/dark mode
8688

8789
Insert the following in your `home.nix` file to change the system theme to dark:
8890

8991
``` nix title="home.nix"
90-
programs.plasma = {
91-
enable = true;
92-
93-
workspace = {
94-
lookAndFeel = "org.kde.breezedark.desktop";
95-
iconTheme = "Papirus-Dark";
92+
programs.plasma.workspace = {
93+
lookAndFeel = "org.kde.breezedark.desktop";
94+
iconTheme = "Papirus-Dark";
9695
};
9796
```
9897

99-
## Setting the wallpaper
100-
## Custom KDE cursor
98+
### Desktop Themes
99+
100+
1. Find a theme you want. Here are some from the official `nixpkgs` repository:
101+
- [kde-gruvbox](https://github.com/printesoi/kde-gruvbox)
102+
- [catppuccin-kde](https://github.com/catppuccin/kde)
103+
- [nordic](https://github.com/EliverLara/Nordic)
104+
- [twilight-kde](https://github.com/yeyushengfan258/Twilight-kde)
105+
- [plasma-overdose-kde-theme](https://github.com/Notify-ctrl/Plasma-Overdose)
106+
- [sweet-nova](https://github.com/EliverLara/Sweet)
107+
- [whitesur-kde](https://github.com/vinceliuice/WhiteSur-kde)
108+
109+
2. Add a line with the nix package name, such as `pkgs.kde-gruvbox`, to the `home.packages` list in the `home.nix` file.
110+
111+
3. Re-apply the flake (`$ nix run home-manager -- switch --flake ~/remote/home-manager`), then run `$ plasma-apply-desktoptheme --list-themes` to check that it was installed.
112+
113+
4. A
114+
115+
### Setting the wallpaper
116+
117+
### Additional Customization!
118+
119+
See [Plasma-Manager Options](https://nix-community.github.io/plasma-manager/options.xhtml)
120+
121+
### Custom KDE cursor
122+
123+
## Terminal Customization
101124

125+
1. https://home-manager-options.extranix.com/
126+
2. Look at the options
127+
3. Set it (ex. programs.kitty.themeFile)
102128

103129
## Debugging and Monitoring
104130

@@ -109,7 +135,7 @@ You can look at the logs and outputs from your desktoprc by running `$ systemctl
109135
## Sample Configs from OCF Staff
110136
- laksith: [.desktoprc](https://github.com/laksith19/ocf-desktoprc/), [home manager flake](https://github.com/laksith19/ocf-home-manager)
111137

112-
- jaysa: [.desktoprc](), [home manager flake]()o
138+
- jaysa: [.desktoprc](), [home manager flake]()
113139

114140
## Resources
115141

0 commit comments

Comments
 (0)