nix/Readme.md

# Dmitry 🌊 NixOS configuration.

## Screenshots.

<details>
<summary>Screenshot 1</summary>
<img src="https://i.imgur.com/F7ki7sQ.jpeg" />
<a href="https://i.imgur.com/0RldJsX.jpeg">Wallpaper link</a>
</details>

<details>
<summary>Screenshot 2</summary>
<img src="https://i.imgur.com/7XMd58c.jpeg" />
<a href="https://pixeldrain.com/api/file/ppeeEr4d">Wallpaper link</a>
</details>

<details>
<summary>Screenshot 3</summary>
<img src="https://i.imgur.com/67nW8XT.jpeg" />
<a href="https://i.imgur.com/H943DFl.jpeg">Wallpaper link</a>
</details>

[My current wallpaper](https://git.voronind.com/voronind/nixos/src/branch/main/module/common/Wallpaper.nix#L2)

Color theming based on wallpaper thanks to [Stylix](https://github.com/danth/stylix).

## Discovering my configuration.

Even tho I've tried to document everything I can in a dum-dum way, I still highly recommend you to learn the [very basics of Nix language](https://nixos.org/guides/nix-pills/). Start from the [Flake](flake.nix) file and follow the comments. If you have any questions, get in touch using [Telegram](https://t.me/voronind_com) or [Email](mailto:hi@voronind.com).

Please tell me if you find any undocumented parts.

## Configuration highlights.

* [Keyd](module/common/Keyd.nix) allows you to have QMK-like keyboard remaps. Killer-feature is the ability to have remaps per-application. I have pretty common remaps like CapsLock to Ctrl/Esc combo, Right Shift to Backspace, Backspace to Delete and overlays for System/Windows/Media/Application controls as well as Macros.
* NixOS Containers (nspawn). Containers are great. I LOVE containers! Containers! Containers! Containers! Containers! Containers! Containers! Containers! Containers! Containers! Containers! Containers! [Here](host/home/Container.nix) is how I add containers to the host, [here](container/default.nix) is the global configuration and [here](container) are all the containers.
* NixOnDroid can be used to set up your environment inside the Termux app on Android. It also gives you access to all the Nixpkgs binaries for Arm. Configuration can be found [here](android/), but you also need to add the definition to the root `flake.nix (nixOnDroidConfigurations.default)`. [Here](https://github.com/nix-community/nix-on-droid) are the docs.
* [Stylix](module/common/Stylix.nix) can be used to change colors for the whole system based on current wallpaper. Example usages: [Sway](module/desktop/sway/module/Style.nix), [fuzzel](user/common/fuzzel/default.nix) and [Tmux](module/common/tmux/module/Status.nix).
* [Signed auto-updates](module/common/AutoUpdateSigned.nix). Updates are pulled every hour and require the last commit to be signed with my signature.

## WIP: NixOS learning roadmap.

0. [Nix Pills](https://nixos.org/guides/nix-pills/). This is a bit controversial one. Try it, but if it's hard to read for you - just skip it for now.

??? Where to look for stuff.  
??? Nix language.  
??? Nix package manager.  
??? Nixpkgs.  
??? Home manager.  

??? (Optional) Remote builders.  
??? (Optional) Live ISO.  
??? (Optional) Dev Shells.  
??? (Optional) Impermanence.  

## Keyboard layouts.

Yellow are modifier keys, they enable layers when held. Green ones are just modified keys.

<details>
<summary>Default</summary>
<img src="https://i.imgur.com/MBb23eB.png" />
</details>

<details>
<summary>Alternative Keys</summary>
<img src="https://i.imgur.com/X9CGhLb.png" />
</details>

<details>
<summary>WM keys</summary>
Sway:<br>
<img src="https://i.imgur.com/rr9OZ64.png" /><br>
Gnome:<br>
<img src="https://i.imgur.com/TrqC5jt.png" />
</details>

<details>
<summary>Per-application controls</summary>
Firefox:<br>
<img src="https://i.imgur.com/GI0apoV.png" /><br>
Jetbrains:<br>
<img src="https://i.imgur.com/scijaJI.png" /><br>
Tmux:<br>
<img src="https://i.imgur.com/Soo85vk.png" />
</details>

<details>
<summary>Extra numbers</summary>
<img src="https://i.imgur.com/PW5eGSF.png" />
</details>

<details>
<summary>Media Controls</summary>
<img src="https://i.imgur.com/FRZ7G2N.png" />
</details>

<details>
<summary>System controls</summary>
<img src="https://i.imgur.com/rBFA2Xu.png" />
</details>

[Link](http://www.keyboard-layout-editor.com) to the tool I used to draw the images.