This repository contains my River dotfiles for Void Linux. I set up this environment primarily for tasks related to my undergraduate studies in Telematics Engineering, especially for operating systems and programming coursework.
I hope this serves as a guide for your rice or for anyone looking to replicate my setup. If you have suggestions or additional configurations, I would greatly appreciate it if you could share them, as I might incorporate them into my setup in the future. If you have any questions about how something works in the setup or the tools I use, feel free to post them in the issues section.
⚠️ Warning: Do not apply my settings to your system unless you fully understand what you are doing. Use at your own risk.
| Category | Tool |
|---|---|
| Distro | Void Linux 🐧 |
| Window Manager | River 🌊 |
| Shell | zsh with powerlevel10k 🐑 |
| Terminal | Foot 🦶 |
| Bar | Waybar with Gruvbox Material theme 📊 |
| Notifications | Mako 🔔 |
| App Launcher | Fuzzel 🚀 |
| File Manager | lf 📂 |
| Editor | Neovim with lazy.nvim 👨💻 |
| PDF Reader | Zathura 📄 |
| System Monitor | btop 📈 |
| Browser | Firefox 🦊 |
| Component | Theme |
|---|---|
| Color Scheme | Gruvbox Material (Medium) |
| GTK Theme | Gruvbox-Material-Dark |
| Icon Theme | Gruvbox Plus; |
| Font (Terminal) | Terminus |
| Font (UI) | JetBrainsMono Nerd Font |
| Tool | Description |
|---|---|
| bat | Cat clone with syntax highlighting |
| lsd | Modern ls replacement |
| wbg | Wallpaper setter for Wayland |
| grim | Screenshot utility |
| slurp | Region selector |
| wl-clipboard | Clipboard for Wayland |
| pamixer | PulseAudio CLI mixer |
| brightnessctl | Brightness control |
| libinput-gestures | Touchpad gestures |
| chafa | Terminal image viewer |
.
├── .config/
│ ├── river/ # Window manager config
│ ├── waybar/ # Status bar
│ ├── foot/ # Terminal emulator
│ ├── fuzzel/ # App launcher
│ ├── mako/ # Notifications
│ ├── nvim/ # Neovim config (lazy.nvim)
│ ├── lf/ # File manager
│ ├── zathura/ # PDF reader
│ ├── btop/ # System monitor
│ ├── bat/ # Bat themes
│ ├── gtk-3.0/ # GTK3 settings
│ ├── gtk-4.0/ # GTK4 settings
│ ├── theme/ # Shared color schemes & wallpapers
│ └── xsettingsd/ # X settings daemon
├── .local/bin/ # Custom scripts
├── .zshrc # Zsh config
├── .p10k.zsh # Powerlevel10k theme
└── .bashrc # Bash fallback
Screenshots coming soon...
| Keybind | Action |
|---|---|
Super + Return |
Open terminal |
Super + Space |
App launcher |
Super + W |
Close window |
Super + J/K |
Focus next/previous |
Super + Shift + J/K |
Swap windows |
Super + H/L |
Resize main ratio |
Super + 1-9 |
Switch workspace |
Super + Shift + Space |
Toggle float |
Super + Shift + F |
Toggle fullscreen |
Super + F |
Firefox |
Print |
Screenshot (region) |
Installation coming soon...
Thanks to these developers for their amazing open source work:
- Isaac Freund - River window manager
- Daniel Eklöf - Foot terminal & Fuzzel launcher
- Alex - Waybar
- Simon Ser - Mako, grim, slurp & Wayland ecosystem
- Roman Perepelitsa - Powerlevel10k
- Folke Lemaitre - lazy.nvim
- Sainnhe Park - Gruvbox Material theme
- gokcehan - lf file manager
- aristocratos - btop
- sharkdp - bat
- Peltoche - lsd