deprecated but not abandoned(the opposite actually)!!!
i have alot of projects but i plan on making a documentation website with extremely detailed instructions.
Made for developers who like very secure systems featuring Lanzaboote, LUKS + TPM, heavily "riced" systems, isolated and reproducible developer environments (via direnv), and fun scripts ive made to automate basic system task. As I learn more about Linux, Nixos, Hyprland, Automation, Systems Development and Programming as a whole, I will update this repo periodically.
I make frequent changes to this repo and all changes (Mostly small UI changes or security tweaks) might not yet be reflected in screenshots or have instructions wriiten for the changes. The end result will have multiple themes and multiple waybar layouts that users can pick from. Once i have enough progress done for an official "version 1.0.0". I will branch this repo and main will be stable. Until then main is very "unstable" in terms of UI changes, but its very cool and very usable. Also the colors in this flake might seem off. This is because I use hyprsunset and you can easily disable it in hyprland.conf
This flake is hardware "agnostic(for lack of a better word)" (because nixos is really Goated like that), but there are a few steps you need to take in order to successfully use this flake. If you dont have luks encryption, you should start with that first. Second, secure boot is not optional with this flake you would be better off just cloning the repo or forking it and just copying what you want. This system flake is designed to be secure (and cool).
The first step you must take is going to your bios settings and turning on secure boot. IMPORTANT!: You must make sure it is in "SETUP_MODE" OR "AUDITED" mode and NOT in "DEPLOYED" mode. (QUICK SIDE NOTE: Normally you would NOT use AUDITED mode but my laptop lacks setup mode and AUDITED mode worked for me and Might work for you.)
When you are in the bios settings, make sure if you have secure boot keys (just do this step anyway) to clear them, reset them, delete them, etc.
(Wouldnt be a bad idea to set a very strong bios password as well.)
Step 2 is to make sure you did step 1 (Actually).
Click fork button above and make a fork of the flake (star this repo too since we already clicking). Now we will clone that fork. If you are on a fresh install you need to install git first
git clone THE-LINK-TO-YOUR-FORK.
(cd into the dotfiles directory and list the subdirectories)
cd ranger097_nixos_dotfiles/hosts/ && ls
You should see 2 host, "deoxy" and "jirachi".
Lets make a new directory.
(Call it your host name.)
mkdir yourHostNameHere
Now you should be inside of the "ranger097_nixos_dotfiles/hosts/" directory. You should have 3 sub-directories deoxy, jirachi, and the directory named after your host (or pokemon). Use this command to paste the "hardware-configuration.nix" from your system to your host directory. (Change "yourHostNameHere" to your actual hostname.)
sudo cp /etc/nixos/hardware-configuration.nix yourHostNameHere/
Now "cd" and "ls" into your host directory and make sure you have a hardware-configuration.nix. If so lets proceed.
Lets open your hardware-configuration.nix.
sudo nano hardware-configuration.nix
Paste this in your hardware-configuration.nix if it doesnt already exist.
boot.initrd.luks.devices."PASTE THE UUID YOU GET WHEN RUNNING THE COMMAND HERE." = {
device = "/dev/disk/by-uuid/PASTE THE UUID YOU GET WHEN RUNNING THE COMMAND HERE.";
crypttabExtraOpts = [ "tpm2-device=auto" ];
};
Look closely in the hardware-configuration.nix where it says:
"boot.initrd.luks.devices"
and on the line below that
"device ="
In another terminal or tab lets run a few commands.
sudo blkid -t TYPE=crypto_LUKS
and or
lsblk -f
My ID is "luks-7c42da92-5364-41d0-900d-68c9410d94e3"
Delete "PASTE THE UUID YOU GET WHEN RUNNING THE COMMAND HERE." and replace it with "YOUR ID" (aka UUID when you run the command above) (Hint: use the highlighted locations displayed in the screenshot if you need help with the formating)
*IMPORTANT: Notice i have 2 luks devices. Big chance you have 1. If so great. If not, add one.
The screenshot above is how i have added my second device if you needed too as well. Save the file and exit back to the terminal.
First run this command to go back to the ranger097_nixos_dotfiles repo.
cd ~/ranger097_nixos_dotfiles
Inside the ranger097_nixos_dotfiles repo lets enter the flake.nix.
sudo nano flake.nix
Okay look at the screenshot below.
Notice how "deoxy" is written 3 times in the flake. Remove the name "deoxy" and write in your hostname in all 3 locations in the highlighted area in the screenshot.
Save the flake.nix and exit the file back to the terminal. We are finally at the point were you can setup secure boot keys
sudo sbctl create-keys
sudo sbctl enroll-keys --microsoft
Make sure you are still in the ~/ranger097_nixos_dotfiles directory. We have made alot of changes and now its time to save those changes to your Github branch.
git add .
git commit -m "added hardware config"
git push origin main
sudo nixos-rebuild switch --flake .#yourHostNameHere
Youre system flake will be built with:
sudo nixos-rebuild switch --flake .#yourHostNameHere
Your remote flake will follow the path:
sudo nixos-rebuild switch --flake github:GITHUB_USER_NAME/GITHUB_REPO_NAME#HOST_NAME
Look at examples of my flake below:
sudo nixos-rebuild switch --flake github:ranger097/ranger097_nixos_dotfiles#jirachi
sudo nixos-rebuild switch --flake github:ranger097/ranger097_nixos_dotfiles#deoxy
Qmmp, Waybar, and waybar module Mpris.
Stylus
Here you will see that youtube has grey text and thumbnails unless hovered over(then its full of color). This is because im a night owl and im trying to limit brightness and bluelight. All played videos are normal with no added effects so its a minimal change in functionality beside saving your eyes (I thought the pixel peepers would apreciate this). That being said this is disabled by default. If you want to achieve this, simply download the userstylus extension in firefox and copy the css i provided in the flake in the "youtube" directory. paste it into the userstylus and Boom!, youre done. Easy.
There is probably 30 or 40 themes included in this flake. Thanks to SWWW, Pywal, and Python, you can easily switch themes as easy as pressing the "theme button" on the bottom left corner. (Quick Note: Waybar is being managed by home-manager and will require you to update the flake in order to reload the waybar theme. If you are using my built-in bash scripts from bash.nix you can just run "jgit" or whatever you decide to change it too). Here are some examples below.
Maple Mono NF is the only font I use. You can easily add more but its so beautiful i use it system wide.
Im a sucker for font ligatures and italics(I need all my fancy programming symbols and fancy cursive functions).
If you are like me and enjoy a good nerd font you might wanna check these out.
Hyprland: Smooth, modern Wayland tiling compositor.
Hyprlock: Fast, GPU-accelerated screen locker.
Hypridle: Automated idle management daemon.
Hyprsunset: Simple blue light filter utility.
Waybar: Highly customizable status bar for Wayland.
wlogout: Graphical power management menu.
NixOS Home-Manager: Declarative user configuration management tool.
Direnv: Automatic environment variable loader per directory.
Qmmp: Audio player with a classic Winamp-style interface.
MPRIS: Standard media control interface for Linux.
Pokeget: Terminal tool to display Pokémon sprites.
VS Code: Extensible source-code editor for developers.
Steam: Digital gaming storefront and launcher.
Firefox: Privacy-focused, open-source web browser.
Complete list of packages contained in this flake.
The cursor depicted in the screenshots above is a Pokemon Cursor (you might be noticing a theme here.) from the KDE Store.
- Theme switcher utilizing Python, Pywal, and Swww.
- Swapped starship for Pure Bash + Pywal; Included a really cool prompt.
- Swapped rofi for walker.
- Updated the shell.nix
- Updated Bash to show git branches, and langauge versions when you enter a project file.
- A website.
- Hyprland settings app.
- More Security features.
- Anime Wallpapers.