Skip to content

README.md

Latest commit

 

History

History
224 lines (175 loc) · 6.26 KB

README.md

File metadata and controls

224 lines (175 loc) · 6.26 KB

❄️ SnowDots

Hyprland dotfiles for Arch Linux. Snow-themed, material-you colored, multi-machine.

OS: CachyOS / Arch x86_64
WM: Hyprland
Shell: fish + starship
Terminal: kitty
Fetch: fastfetch
Launcher: fuzzel / rofi
Colors: matugen (Material You)
Bar: waybar
Notifications: swaync

Quick Start

curl -sL https://raw.githubusercontent.com/Snowiseverything/snowdots/main/scripts/install.sh | bash

This clones the repo to ~/Dotfiles and launches the interactive installer. No git? The script installs it. No dependencies? You pick what to install.

Or clone and run manually:

git clone https://github.com/Snowiseverything/snowdots.git ~/Dotfiles
bash ~/Dotfiles/scripts/snow-dots install

GitLab mirror

curl -sL https://gitlab.com/sn0wman/snowdots/-/raw/main/scripts/install.sh | bash

Features

  • Hyprland — Dynamic tiling, smooth animations, material-you colors
  • fish — Auto-complete, autopair, pure prompt, fuzzy file nav with fzf
  • kitty — GPU-accelerated terminal with material-you theme
  • starship — Minimal, fast prompt
  • waybar — Status bar with workspaces, volume, brightness, network, clock
  • fuzzel — Fuzzy app launcher with material-you colors
  • swaync — Notification center
  • dunst — Lightweight notifications
  • matugen — Material You theme generator from wallpaper
  • wall-sync — Automatically generate theme from wallpaper
  • dotsync — Unified git sync across machines

Structure

~/
├── Dotfiles/          ← This repo
│   ├── scripts/       ← dotsync, snow-dots, audit, publish, etc.
│   ├── fish/          ← config.fish, functions, conf.d/
│   ├── hypr/          ← hyprland.conf, hypridle.conf, keybinds
│   ├── kitty/         ← kitty.conf + material-you theme
│   ├── starship/      ← starship.toml
│   ├── fastfetch/     ← config.jsonc, logo
│   ├── waybar/        ← style.css, config
│   ├── swaync/        ← notification config
│   ├── dunst/         ← dunstrc
│   ├── wofi/          ← wofi style
│   ├── wallpaper/     ← current wallpaper + themes
│   ├── matugen/       ← material-you templates
│   ├── ssh/           ← authorized_keys placeholder
│   ├── README.md      ← This file
│   └── README-SETUP.md ← Legacy (content merged here)

Setup

1. Interactive Installer (Recommended)

bash <(curl -sL https://raw.githubusercontent.com/Snowiseverything/snowdots/main/scripts/snow-dots.sh)

Or clone and run locally:

git clone https://github.com/Snowiseverything/snowdots.git ~/Dotfiles
bash ~/Dotfiles/scripts/snow-dots.sh

What it does:

  • Detects your distro (Arch, Debian, Fedora)
  • Backs up your current config to ~/.dotfiles-backup-* before touching anything
  • Installs packages (Hyprland, fish, kitty, waybar, fonts, etc.)
  • Detects if you use bash/fish/zsh and adjusts PATH setup accordingly
  • Sets up symlinks for all configs
  • Installs fisher + plugins (if fish is installed)
  • Sets fish as default shell (optional)
  • Shows restore instructions at the end

Want to undo? Run snow-dots restore and pick your backup.

snow-dots CLI

After install, snow-dots is available as a command:

Command Description
snow-dots help Show help
snow-dots install Run interactive installer
snow-dots backup Backup current dotfiles
snow-dots restore Restore from a backup
snow-dots list List available backups

2. Manual Setup

# Symlink configs
ln -sf ~/Dotfiles/fish ~/.config/fish
ln -sf ~/Dotfiles/kitty ~/.config/kitty
ln -sf ~/Dotfiles/fastfetch ~/.config/fastfetch
ln -sf ~/Dotfiles/hypr/hyprland.conf ~/.config/hypr/hyprland.conf
ln -sf ~/Dotfiles/hypr/hypridle.conf ~/.config/hypr/hypridle.conf
ln -sf ~/Dotfiles/starship/starship.toml ~/.config/starship.toml

# Link scripts
mkdir -p ~/.local/bin
for script in ~/Dotfiles/scripts/*.sh; do
    ln -sf "$script" ~/.local/bin/$(basename "$script")
done
ln -sf ~/Dotfiles/scripts/dotsync ~/.local/bin/dotsync

3. Package Dependencies

Arch:

sudo pacman -S --needed hyprland fish kitty waybar wofi fuzzel swaync \
  dunst wlogout starship fastfetch grim slurp swappy wl-clipboard \
  polkit-kde-agent xdg-desktop-portal-hyprland \
  ttf-jetbrains-mono-nerd ttf-meslo-nerd noto-fonts-emoji

# AUR
yay -S matugen-bin hyprland-guiutils

Debian/Ubuntu:

sudo apt install fish kitty starship fastfetch grim slurp wl-clipboard \
  fonts-jetbrains-mono fonts-noto-color-emoji
# Hyprland must be built from source or use the hyprland repo

Sync

dotsync

On Freezer: pulls from GitLab, pushes to GitLab + optionally to GitHub (sanitized). On SnowPi: pulls from GitLab, pushes to GitLab + optionally to peer.

GitHub Publish

After dotsync, you'll be asked:

📢 Publish sanitized version to GitHub? [y/N]

This runs scripts/publish-public.sh which:

  1. Clones the repo to a temp directory
  2. Strips personal info (SSH keys, IPs, .opencode/)
  3. Asks confirmation
  4. Force-pushes sanitized copy to GitHub

This keeps private info on GitLab and only polished, public-safe content on GitHub.

Remotes

Freezer (desktop)

gitlab → git@gitlab.com:sn0wman/snowdots.git
github → git@github.com:Snowiseverything/snowdots.git

SnowPi (RPi4)

origin → git@gitlab.com:sn0man/snowpi-dotfiles.git

Keybinds

Key Action
Super + Return kitty
Super + D fuzzel launcher
Super + Q Close window
Super + F Toggle fullscreen
Super + V Toggle floating
Super + 1-9 Switch workspace
Super + Shift + 1-9 Move window to workspace
Super + Shift + C Kill window
Super + Shift + S Screenshot region
Super + L Lock screen
Super + Space Toggle layout
Super + arrows Move focus
Super + Print Screenshot full
Ctrl + T fzf (files)
Ctrl + R fzf (history)
Alt + C fzf (dirs + cd)

Wallpaper & Themes

Place wallpapers in ~/Dotfiles/wallpaper/ and run:

bash ~/Dotfiles/scripts/wall-sync.sh

This runs matugen on the current wallpaper and updates kitty, waybar, fuzzel, and hyprland colors.

License

MIT