update+reorganise README.md

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

49
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,15 +50,22 @@ 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