Tinydots

This project is:

• A starter or template for beginner to use Nix on non-NixOS distro.
• A lightweight repo which setups minimal desktop environment (based on Hyprland and waybar) quickly.
• An elegant solution for Debian stable users (e.g. the repo owner, @clsty) who want to use Hyprland.

Features

• Idempotent install script.
• Powered by Nix with Home-manager to achieve cross distro.
  • Tested on Debian 13.

Note: Configuration files are not managed by Home-manager for those customed to the traditional way managing dotfiles, except for several files under ~/.config/fontconfig/conf.d/.

Installation

Clone this repo and run ./setup install to install:

git clone --depth=1 https://github.com/clsty/tinydots && cd tinydots && ./setup install

Notes:

• zsh and swaylock are still installed by system PM (Package Manager) due to limitation of Nix on non-NixOS distros.
• curl and git are also needed to be installed by system PM, but this is actually that you need curl and git for the install script itself.

Run ./setup -h for more subcommands.

Run ./setup <subcommand> -h for more options.

Launch

The install script will set Zsh as default shell, and Hyprland will autostart after the login on tty1.

Alternatively, to launch Hyprland, login on a tty and run hyprland;exit.

Usage

Tip

Notations used below:

• <num>: Number keys from 0 to 9
• <arrow>: Keys representing 4 directions (supports vim-like "HJKL"):
  • Left: ← or H
  • Right: → or L
  • Up: ↑ or K
  • Down: ↓ or J

Basic keybinds:

• Super+Return: Launch terminal.
• Super+X: Close window.
• Super+/: App launcher.
• Super+V: Clipboard history.
• Super+F1: Lock screen.
• Super+Delete: Power menu.
• Super+Ctrl+[/]: Toggle left/right panel.

Navigate:

• Super+<arrow>: Switch window focus.
• Super+<num>: Switch to workspace <num>.
• Super+[/]: Switch to prev/next workspace.

Control window:

• Super+Shift+<arrow>: Move window position.
• Super+Alt+<arrow>: Resize window.
• Super+;: Change window split orientation.
• Super+Shift+<num>: Move window to workspace <num>.

For other keybinds see ~/.config/hypr/hyprland/keybinds.conf.

Run yazi to open filemanager.

Credits

Thanks for all developers and contributors of the FOSS projects involved in this repo. Some of them are listed below:

• Zsh
• Oh-my-zsh
• Powerlevel10k
• Foot
• Hyprland
• Waybar
• Swaylock
• Nix
• Home-manager
• Yazi