update+reorganise README.md

This commit is contained in:
Emile Clark-Boman 2025-07-26 18:30:04 +10:00
parent 8613df22fd
commit 97d6d8919c

59
README.md Executable file → Normal file
View file

@ -1,11 +1,8 @@
## My NixOS Flake
### Philosophy ### Philosophy
I try to use Home Manager as little as possible. When I first started with NixOS I found > [!TODO] My philosophy has kinda changed since the beginning
it distracting and confusing. NixOS already handles system wide and user packages, so having
another user level package management method was baffling. Obviously I understand now how
it can be useful (so I do use it). But where possible I will instead use the functionality
of Nix rather than Home Manager.
###### Structuring Modules ###### Repo Structure
Modules are organised into groups (ie "Core"), from here a module is structured as either: Modules are organised into groups (ie "Core"), from here a module is structured as either:
1. a single `.nix` file (ie bluetooth.nix). I do this when I won't implement an alternative 1. a single `.nix` file (ie bluetooth.nix). I do this when I won't implement an alternative
2. a directory (ie `sound`) containing a set of alternative implementations and a `default.nix` 2. a directory (ie `sound`) containing a set of alternative implementations and a `default.nix`
@ -13,15 +10,14 @@ that simply imports one of the implementations. For the `sound` example I curren
to default to `pipewire.nix`. I haven't made alternatives yet but the idea is that it is HIGHLY likely to default to `pipewire.nix`. I haven't made alternatives yet but the idea is that it is HIGHLY likely
I do in future. I do in future.
### TODO ### TODO
There are a lot of `TODO` items in this repository. To improve these dotfiles There are a lot of commented `# TODO: ...` items in this repository.
I should run a command to find files containing "TODO" and then implement the All (most) of my commented directives can be found via this pattern:
recommendation I left behind :) ```sh
grep -rnE '^\s*(//|#)\s*[A-Z]*:\s*.+$' --exclude-dir=.git 2>/dev/null
```
### Random Explanation of Fonts
##### Small Explanation of Fonts
There are four types of fonts (to my knowledge at least): There are four types of fonts (to my knowledge at least):
1. serif (funny squigles / small elegant strokes included) 1. serif (funny squigles / small elegant strokes included)
2. sans-serif (meaning "without serifs") 2. sans-serif (meaning "without serifs")
@ -33,19 +29,9 @@ Fun fact: on Android, the emojis you are seeing are part of the noto-emoji font
For finding a font for programming I highly recommend trying https://www.codingfont.com/ For finding a font for programming I highly recommend trying https://www.codingfont.com/
### My config ### Links
#### Inspiration
Font: ##### Explaining my Vision with r/unixporn posts
Iosevka nerd font set as default/prefered font
Terminal uses IosevkaTerm nerd font
Home-Manager:
I just to use home-manager standalone and not as a NixOS module, thus allowing
my dotfiles to also work on non-NixOS systems.
### Explaining my Vision with r/unixporn posts
I want the side panel from https://www.reddit.com/r/unixporn/comments/12wpvyf/hyprland_eww_is_all_i_need/ I want the side panel from https://www.reddit.com/r/unixporn/comments/12wpvyf/hyprland_eww_is_all_i_need/
but not the colour scheme and I'm 50/50 on the bar being on th eleft side lol. Also I love the volume bar on the right! but not the colour scheme and I'm 50/50 on the bar being on th eleft side lol. Also I love the volume bar on the right!
@ -64,22 +50,29 @@ Their window decorations and bar are great, also being able to hide everything u
https://www.reddit.com/r/unixporn/comments/vkcasz/i3gaps_i_prefer_light_mode/ https://www.reddit.com/r/unixporn/comments/vkcasz/i3gaps_i_prefer_light_mode/
If their colour scheme was a little less white I'd love it but overall one of my favourites every If their colour scheme was a little less white I'd love it but overall one of my favourites every
##### Other Inspiring Shtuff
1. https://github.com/sabrehagen/desktop-environment
### Wallpaper Sources #### Wallpaper Sources
1. https://www.wallpaperflare.com/ 1. https://www.wallpaperflare.com/
2. https://alphacoders.com 2. https://alphacoders.com
especially this one person: https://alphacoders.com/users/profile/69089/robokoboto especially this one person: https://alphacoders.com/users/profile/69089/robokoboto
and also the lofi category: https://alphacoders.com/lofi and also the lofi category: https://alphacoders.com/lofi
#### Teach Yourself Nix
1. https://github.com/XNM1/linux-nixos-hyprland-config-dotfiles)
Really good security oriented NixOS stuff
2. https://jade.fyi/blog/flakes-arent-real/
Interesting blog post on using flakes
### Credits #### Credits
1. https://github.com/XNM1/linux-nixos-hyprland-config-dotfiles 1. https://github.com/XNM1/linux-nixos-hyprland-config-dotfiles
The simplicity of their layout is amazing, was really good to pick out small modules and learn how something works / is configured. The simplicity of their layout is amazing, was really good to pick out small modules and learn how something works / is configured.
2. https://github.com/Misterio77/nix-starter-configs 2. https://github.com/Misterio77/nix-starter-configs
Really great starter config for learning how parts interact and how to generally structure flakes Really great starter config for learning how parts interact and how to generally structure flakes
3. https://nixos.wiki/wiki/Fonts 3. https://nixos.wiki/wiki/Fonts
Wiki page explaining how to install fonts and nerd fonts on NixOS Wiki page explaining how to install fonts and nerd fonts on NixOS
4. https://github.com/adi1090x/rofi 4. https://github.com/adi1090x/rofi
For the Rofi theme For the Rofi theme
5. https://github.com/zDyanTB/HyprNova 5. https://github.com/zDyanTB/HyprNova
For the really cool hyprlock theme For the really cool hyprlock theme