Open source · 2026

dotfiles

Free · Open source
  • Rust

Questions

Is dotfiles free?

Yes. dotfiles is free to use and open source. The full source code is on GitHub at https://github.com/kshitizwagle/dotfiles.

How do I get dotfiles?

Get the source from https://github.com/kshitizwagle/dotfiles; the README there covers installation and usage.

Is there a warranty or support for dotfiles?

No. dotfiles was built with AI assistance and is provided as is, without warranty. Kshitiz Wagle is not liable for damage or loss. Use it at your own risk.

Who makes dotfiles?

dotfiles is built and maintained by Kshitiz Wagle, a software engineer in Lalitpur, Nepal. Portfolio: https://kshitizwagle.com.np.

README

Ubuntu 26.04 · GNOME 50 + Hyprland 0.53 · Aura Dark

Desktop

The home screen: aura-panel's cards on the desktop layer (they sit under windows), the aura-bar dock, and the top bar with the English · weekday · Nepali date.

Side panel

aura-panel (Super+D): power with confirmation, primary monitor, Ethernet / Wi-Fi / Bluetooth, notification history and Do Not Disturb. The same panel's home-screen cards (Docker stacks, now playing with a seekable spectrum bar, live CPU / memory / GPU / disk graphs, lights, sound) sit on the desktop.

Side panel

Calendar

Click the top-bar clock: a month view in Gregorian or नेपाली (Bikram Sambat) with the other calendar's day under each date, previous/next month, Today, and Saturdays (Nepal's weekly holiday) in red.

Calendar

Launcher

vicinae (Alt+Space) in the Aura theme; Super+Alt+V shows clipboard history in the same window.

Launcher

Terminal

Ghostty with Neovim (the official Aura port), and macOS-style traffic-light titlebars from hyprbars.

Neovim in Ghostty

Power menu

wlogout (Super+Esc): a 2 × 2 grid of Aura cards over the blurred wallpaper.

Power menu

Lock screen

hyprlock: one Aura card with the time, the English · weekday · Nepali (BS) date, and an avatar from ~/.face (.config/hypr/scripts/set-avatar.sh <picture>), falling back to an initial.

Lock screen

Fresh setup

git clone https://github.com/kshitizwagle/dotfiles.git ~/dotfiles && cd ~/dotfiles
scripts/packages.sh      # apt packages + BlexMono Nerd Font (sudo)
./install.sh             # symlink configs into $HOME (backs up existing files)
scripts/gnome.sh         # GNOME settings + extensions
scripts/gdm-theme.sh     # Aura login screen (sudo)
scripts/refind-theme.sh  # rEFInd config + Aura boot theme (sudo)

# Hyprland bar and side panel (Rust)
cargo install --path .config/hypr/aura-bar   --root ~/.local
cargo install --path .config/hypr/aura-panel --root ~/.local

Run ./install.sh --dry-run first to see what it will do.

  • New machine? Add hosts/$(hostname)/ first (monitors, GPU order). See .claude/skills/new-machine.
  • SSH: .ssh/config is gitignored. On first install it's seeded from .ssh/config.example, so fill in your own hosts.
  • Wallpapers live in Pictures/wallpapers/ and are linked to ~/Pictures/wallpapers/. See the wallpapers README for previews and how to switch them.
  • Nothing hardcodes a username or home path, so it works under any account.

What's here

TerminalGhostty, Aura palette, BlexMono Nerd Font, iTerm-style keys
Shellzsh + oh-my-zsh, starship prompt
EditorNeovim with the official Aura port
GNOMElibadwaita recolored with CSS variables (no forced theme), Papirus-Dark, autohide dock
Hyprland1px accent borders, 6px radius, no window blur, aura-bar dock, aura-panel sidebar, vicinae, hyprlock/hypridle, wlogout
LoginAura GDM theme built on Ubuntu's Yaru
BootrEFInd with a custom Aura theme

Keys

Hyprland | Key | Action | |---|---| | Super+Enter | Ghostty | | Super+Space | Launcher (fuzzel) | | Alt+Space | vicinae | | Super+D / Super+N | Side panel | | Super+Alt+V | Clipboard history (in vicinae) | | Super+1…5 | Go to workspace | | Super+Shift+1…5 | Move window to workspace | | Super+Shift+D | New workspace on this monitor | | Super+Shift+← / → | Previous / next workspace on this monitor | | Ctrl+Shift+M | Hide / show every window on this screen | | Super+Shift+M | Bring back the last minimized window | | Super+Shift+S / Print | Area screenshot to clipboard | | Shift+Print | Area screenshot to ~/Pictures/Screenshots | | Super+L | Lock | | Super+Q | Close window (Spotify goes to the tray) | | Super+Shift+E | Power menu (also Super+Esc) |

Titlebar buttons: red closes, yellow minimizes, green gives the window its own workspace (press again to return).

Ghostty | Key | Action | |---|---| | Ctrl+T | New tab | | Ctrl+Shift+W | Close tab | | Ctrl+1…8 / Ctrl+9 | Go to tab / last tab | | Ctrl+Tab / Ctrl+Shift+Tab, Ctrl+Shift+← | Next / previous tab | | Ctrl+Shift+→ / Ctrl+Shift+↓ | Split right / down | | Ctrl+Alt+Arrows | Move between splits | | Ctrl+Shift+Enter | Zoom split | | Ctrl+V | Paste | | F11 | Fullscreen |

Design spec: docs/aura-tokens.md. Agent guide: AGENTS.md. Credits: docs/THIRD_PARTY.md.

← All projectsSource on GitHub ↗