https://github.com/engineervix/dotfiles
dotfiles for a Hyprland environment on openSUSE Tumbleweed
https://github.com/engineervix/dotfiles
hyprland opensuse-tumbleweed
Last synced: 20 days ago
JSON representation
dotfiles for a Hyprland environment on openSUSE Tumbleweed
- Host: GitHub
- URL: https://github.com/engineervix/dotfiles
- Owner: engineervix
- License: mit
- Created: 2026-05-04T09:40:27.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-04T10:45:59.000Z (about 1 month ago)
- Last Synced: 2026-05-04T12:35:18.802Z (about 1 month ago)
- Topics: hyprland, opensuse-tumbleweed
- Language: Shell
- Homepage: https://engineervix.github.io/dotfiles/
- Size: 74.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dotfiles
[](https://github.com/engineervix/dotfiles/actions/workflows/deploy.yml)
Personal configurations for a productivity-focused Hyprland environment on openSUSE Tumbleweed.
## Directory Structure
```text
install.sh # Bootstrap: creates all symlinks, safe to re-run
.zshrc # Shell config (SSH + GPG agent, PATH, tools)
.zshrc.local # Machine-specific overrides (not tracked)
.gnupg/
└── gpg-agent.conf # GPG agent passphrase cache (24h TTL)
docs/
├── cheatsheets/ # HTML quick-reference sheets
└── notes/
└── post-setup.md # Architecture decisions and setup notes
scripts/
└── setup-sddm.sh # Sync wallpaper to SDDM login screen
.config/
├── hypr/
│ ├── conf/ # Modular Hyprland settings
│ │ ├── autostart.conf
│ │ ├── custom.conf
│ │ ├── environment.conf
│ │ ├── input.conf
│ │ ├── keybindings.conf
│ │ ├── looks.conf
│ │ ├── monitors.conf
│ │ └── rules.conf
│ ├── scripts/ # Helper scripts (exit, recorder, monitor setup)
│ ├── hyprland.conf # Main entry point (sources modular conf/)
│ ├── hypridle.conf # Idle & sleep management
│ ├── hyprlock.conf # Secure lockscreen
│ └── hyprpaper.conf # Wallpaper management
├── dunst/ # Notification daemon
├── imv/ # Image viewer
├── kitty/
│ ├── kitty.conf # GPU-accelerated terminal
│ └── mocha.conf # Catppuccin Mocha theme
├── rofi/
│ └── config.rasi # App launcher (Catppuccin Mocha theme)
├── waybar/
│ ├── config # Status bar layout
│ ├── colors.css # Catppuccin Mocha colour tokens
│ ├── modules.json # Module definitions
│ ├── style.css # Status bar styling
│ └── scripts/
│ └── weather.sh # Weather widget (wttr.in)
├── wireplumber/
│ └── wireplumber.conf.d/ # Bluetooth audio policy
├── chrome-flags.conf # Chrome/Chromium startup flags
├── Thunar/ # File manager config
├── mimeapps.list # Default app associations
└── starship.toml # Shell prompt
```
## Key Bindings (SUPER)
| Binding | Action |
| ------------------- | --------------------------------------------------------------- |
| `Q` | Terminal (Kitty) |
| `R` | App launcher (Rofi) |
| `E` | File manager (Thunar) |
| `C` | Kill active window |
| `V` | Toggle floating |
| `L` | Lock screen (hyprlock) |
| `M` | Exit Hyprland |
| `SHIFT+M` | Logout menu (wlogout) |
| `H` | Clipboard history (cliphist + Rofi) |
| `W` | Enter resize mode (arrow keys to resize, `ESC`/`ENTER` to exit) |
| `SHIFT+B` | Reload Waybar |
| `1-0` | Switch workspaces |
| `TAB` | Toggle between last two workspaces |
| `SHIFT+left/right` | Move active window to prev/next workspace |
| `SHIFT+1-0` | Move active window to workspace |
| `Arrow keys` | Move focus |
| `SHIFT+hjkl` | Move windows |
| `G` | Toggle window group |
| `[` / `]` | Cycle group tabs |
| `CTRL+G` / `ALT+G` | Move window out of / into group |
| `ALT+TAB` | Window switcher (Rofi, all workspaces) |
| `Print` | Screenshot to file |
| `SUPER+Print` | Screenshot selection to clipboard |
| `SUPER+SHIFT+Print` | Screenshot selection to file |
## Changing the Wallpaper
Edit `.config/hypr/hyprpaper.conf` and update the `path`:
```ini
wallpaper {
monitor =
path = /home/victor/Pictures/your-image.jpg
fit_mode = cover
}
```
Then reload: `pkill hyprpaper; hyprpaper &`
- Supported formats: PNG, JPG, JXL, WebP
- `fit_mode` options: `cover` (default), `contain`, `tile`, `fill`
- For a different wallpaper per monitor, add multiple `wallpaper {}` blocks with specific `monitor = eDP-1` etc., and keep one with `monitor =` (empty) as a fallback
To also update the SDDM login screen wallpaper, run `scripts/setup-sddm.sh` (with `sudo`) after changing the path there too.
## Bootstrap
On a fresh machine, clone this repository to `~/dotfiles` and run the install script:
```bash
git clone ~/dotfiles
~/dotfiles/install.sh
```
`install.sh` creates all symlinks (`~/.config/*`, `~/.zshrc`, `~/.gnupg/gpg-agent.conf`), backing up any existing file or directory with a timestamped suffix before replacing it. It is safe to re-run.
On a fresh openSUSE Tumbleweed install, the dotfiles bootstrap is handled automatically by the [opensuse-setup](https://github.com/engineervix/opensuse-setup) script as part of its final phase.
## Setup Notes
- **OS:** openSUSE Tumbleweed
- **Keyboard Layout:** en-gb (`gb`)
- **Login Manager:** SDDM (auto-login disabled)
_Refer to [docs/notes/post-setup.md](docs/notes/post-setup.md) for full details on the configuration architecture._
## Credits
- [mylinuxforwork/dotfiles](https://github.com/mylinuxforwork/dotfiles) — ML4W Hyprland dotfiles, primary inspiration
- [mylinuxforwork/hyprland-starter](https://github.com/mylinuxforwork/hyprland-starter) — minimal Hyprland starter config
- [mylinuxforwork/ml4w-dotfiles-installer](https://github.com/mylinuxforwork/ml4w-dotfiles-installer) — dotfiles installer tooling
- [Hyprland Wiki](https://wiki.hyprland.org/) — official Hyprland documentation