README.md
August 9, 2026 · View on GitHub
💻 My dotfiles for rice AwesomeWM
to my dotfiles! Here are some details about my setup
🧰 Information
Here are some details about my setup:
- OS: Arch Linux
- WM: awesome (With Picom) and Hyprland
- Terminal: kitty
- Shell: zsh
- Application Launcher: rofi
- Editor: neovim | vscode | zed
- System Font: SF Pro Display
🎢 installation
🌀 Clone this repository
git clone --recurse-submodules https://github.com/Savecoders/dotfiles.git
cd dotfiles && git submodule update --remote --merge
📥 Use the script
chmod +x scripts/install.sh && ./scripts/install.sh
📦 NixOS
The repository ships a flake that reproduces the desktop declaratively on NixOS:
# Personal convenience outputs (owner)
home-manager switch --flake .#$(whoami) --impure
# NixOS system (import nix/modules + home-manager; add hardware-configuration.nix
# and bootloader options in a real host)
sudo nixos-rebuild switch --flake .#desktop --impure
# Dev shell with Nix tooling
nix develop
Note
nixosConfigurations."desktop" is a composable base: combine it with a
hardware-configuration.nix, bootloader and filesystem config for a full system.
{
inputs.savior.url = "github:Savecoders/dotfiles";
inputs.home-manager.url = "github:nix-community/home-manager";
outputs = { self, nixpkgs, home-manager, savior, ... }@inputs: {
nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
specialArgs = { inherit inputs; };
modules = [
home-manager.nixosModules.home-manager
savior.nixosModules.default
{
services.saviorDesktop.enable = true;
home-manager.users.YOUR_USER = {
imports = [ savior.homeManagerModules.default ];
programs.saviorDotfiles.enable = true;
};
}
];
};
};
}
Tip
All flake inputs are optional: the modules fall back to nixpkgs when a pinned
input (hyprland, vicinae, bling, layout-machi, quickshell) is absent. With
the vicinae input present, the NixOS module wires the input-server automatically.
Warning
⚠ Critical content demanding immediate user attention due to potential risks.
⁉ Error clone submodules?
In this case you need clone the submodules with repositories and move folders
mkdir dev && cd dev && git clone https://github.com/Savecoders/dotfiles.git
git clone https://github.com/xinhaoyuan/layout-machi.git
git clone https://github.com/BlingCorp/bling.git
git clone https://github.com/Savecoders/simpleTheme-zsh-theme
cp -r layout-machi/* dotfiles/config/awesome/modules/layout-machi/
cp -r bling/* dotfiles/config/awesome/modules/bling/
cp -r simpleTheme-zsh-theme/* dotfiles/assets/zsh/Savior-zsh-theme
Important
Do you want to install manually? Please continue with the manual installation.
Installation Manual Dotfiles
Install Dependencies
paru -Sy awesome-git picom-git kitty rofi acpi acpid acpi_call upower \
jq inotify-tools xdotool xclip gpick ffmpeg blueman zsh-autosuggestions \
pamixer brightnessctl scrot redshift rainfall zsh-syntax-highlighting \
feh mpv mpd mpc mpdris2 ncmpcpp playerctl tunar zsh --needed
Enable Services
systemctl --user enable mpd.service
systemctl --user start mpd.service
Clone this repository
git clone https://github.com/Savecoders/dotfiles.git
cd dotfiles
Use config
cp -r config/* ~/.config/
cp -r assets/fonts/* ~/.local/share/fonts/
cp -r assets/zsh/.zshrc ~
Use others rxfetch
cd neofetch && chmod +x singfetch
sudo cp -r singfetch /usr/bin/
Install ohmyzsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
🔵 AwesomeWM
Dark Theme Mode
Grubox Theme Mode
Light Theme Mode
Special Thanks
The dotfiles is based in and the other parts of code is the others devs :)
Quetions
- Fonts and icons
- as for fonts, the setup uses 4 fonts in total
- SF Pro Display - my main ui font
- Font Awesome 6 Free - for icons the weather
- JetBrainsMono NF - icons of signals
- Cascadia Code - Editor/terminal
- in the tag config, using images for icons, the images They're in
awesome/icons/tag/
- as for fonts, the setup uses 4 fonts in total
- custom theme?
- for dark, edit
theme/dark/dark.lua - for light, edit
theme/light/light.lua - agg display theme selection
theme/selection_theme.lua
- for dark, edit
- wallpapers and profile
- by default wallpapers are found by theme - example:
theme.wallpaper = gfs.get_configuration_dir() .. "wallpapers/hands.jpg"- in wallpapers folder add new wallpapersawesome/wallpapers- replace existing wallpapers with new ones in:"wallpapers/new_walpapers.jpg"
- by default wallpapers are found by theme - example: