dotfiles

This is a repository containing all of my configurations of my current rice. I use GNU Stow to manage my dotfiles (for a tutorial, click here).

Available Configs

• Bash - backup shell
• Fish - main shell
• Flameshot - powerful screenshot tool
• Hyprland - Wayland compositor
  • hypridle - idle daemon
  • hyprlock - lockscreen
• IPython - interactive Python shell
• Kitty - terminal emulator
• Kvantum - QT theme engine
• NeoVim - text editor
• OpenCode - LLM harness
• Ruff - Python linter, formatter and LSP
• Wofi - GTK-based app launcher
• ashell - status bar
• jai - lightweight sandbox for LLM agents
• latexmk - LaTeX build tool
• tmux - terminal multiplexer
• wpaperd - Wayland wallpaper daemon

Requirements

• GNU Stow - tool used for managing dotfiles
• Hyprland plugins:
  • hy3 - Hyprland plugin for i3-like layout
  • hyprexpo - Hyprland plugin for a workspace overview like Gnome or KDE
  • hypr-dynamic-cursors - Hyprland plugin for cursor shake-to-find
• Fish plugins:
  • fisher - plugin manager
  • tide - plugin for the prompt
• Fish config:
  • Fortune - tool for random adages
  • Cowsay - tool for making Tux say the random adages
  • Dotacat - tool for colouring Tux saying the random adages
• Themes and fonts:
  • vimix-dark-beryl - GTK theme
  • VimixBerylDark - Kvantum theme (for Qt applications)
  • Papirus-Dark - icon theme
  • papirus-folders - tool for setting folder icon colours
  • Breeze Light (from KDE Plasma) - cursor theme
  • Roboto - font
  • JetBrainsMono Nerd Font - monospace font

Instructions

Simply use Stow on all the folders in this repository (except for the screenshots and the nvim folder). For example, for using my Fish config, do:

stow -t ~ fish

For my NeoVim setup, use Stow on the config folder inside the nvim folder as follows:

cd nvim
stow -t ~ config

Further instructions can be found in the README of that repo: https://github.com/rharish101/vim-config.

Papirus Folders

Run the following command to set the folder colors of the Papirus-Dark theme to match the Vimix GTK theme's colorscheme:

papirus-folders -C teal --theme Papirus-Dark

Fish plugins

To install and configure the fish plugins:

1. Install fisher.
2. Install all plugins:

   fisher update

3. Follow the configure wizard of tide to set up your prompt the way you want it. If you missed it, or accidentally cancelled it, then run:

   tide configure

Screenshots

Current Desktop

Lockscreen

Terminal

Colourscheme

Fortune + Cowsay + Dotacat

Fish

Bash

NeoVim

IPython

Tmux

Licenses

This repository uses REUSE to document licenses. Each file either has a header containing copyright and license information, or has an entry in the TOML file at REUSE.toml. The license files that are used in this project can be found in the LICENSES directory.

The MIT license is placed in LICENSE, to signify that it constitutes the majority of the codebase, and for compatibility with GitHub. All screenshots are under the CC-BY-SA-4.0 license.