maximbaz / dotfiles

Configuration for Arch Linux, Hyprland, kitty, kakoune, zsh and more

~/.dotfiles

Explore the repo and incorporate what you like into your own setup. If you have any questions, comments or suggestions, feel free to open an issue or PR!

When you fork, remember to grep for maximbaz and replace with your username.

Installation script is deploying an opinionated Arch Linux setup, but in general can be used by anyone. If you want to learn more, I highly recommend to at least read the installation script first, and maybe modify to your own needs.

If you want to try my entire setup in a VM, make sure to use maximbaz as the username - it will install additional things and my dotfiles.

For daily usage, I recommend forking my repo instead of using it directly, as I am changing things on daily basis 🙂

Enjoy! 🚀

Some of the worthy tools that I use, develop or help maintain:

• Hyprland (window manager) + waybar (status bar)
• kitty - fast GPU-accelerated terminal
• kakoune - modular text editor with multiple cursors
• zsh + powerlevel10k and various other plugins
• yubikey-touch-detector - a tool that can detect when your YubiKey is waiting for a touch.
• browserpass - browser extension for pass and gopass.
• wire-desktop - end-to-end encrypted chat app.
• wluma - automatic brightness adjustment based on screen contents.
• wl-clipboard-manager - clipboard manager for Wayland.
• ttf-joypixels - latest JoyPixels font that provides colorful emojis for almost all apps on Linux (formerly EmojiOne).
• aurutils - the most reasonable AUR helper out there.
• xplr - hackable, minimal and fast file manager.
• arch-secure-boot + snap-pac - UEFI Secure Boot for Arch Linux + btrfs snapshots during system update.

Fun things you can find in this repo:

☑ A common color scheme for kakoune, terminal and Hyprland itself.

It is called Gruvbox dark.

☑ Unobtrusive and minimalistic design of Hyprland, waybar and terminal.

Display only actionable items, use color to highlight importance, slightly dim inactive windows.

☑ True Color support everywhere.

Including kitty, kakoune; terminal can even display picture previews.

☑ Almost instant terminal startup.

And yet it is empowered with antigen, prezto, powerlevel10k and other plugins.

☑ More secure gpg and ssh configuration.

Stronger algorithms, more sensible defaults.

☑ gpg-agent configured to act as ssh-agent.

Extremely nicely integrated with YubiKey, with forwarding to selected remote hosts.

☑ Hyprland automatically renames workspaces to show currently opened apps.

Using iconic font to fit a lot of info even on laptop screens.

☑ Automatically change terminal's background color based on the ssh host.

Terminal turns red when you are on production, yellow on staging, etc.

☑ Automatically adjust brightness level based on screen contents and amount of ambient light around.

Useful for working at night, e.g. by dimming screen when switching from a dark terminal to a bright browser.

☑ Automatically backup the list of installed packages (pacman and AUR).

These files are used to bootstrap the new system, all apps are installed in one command.

☑ Setup script that configures user and system dotfiles, systemd services and other little things.

This script is safe to re-run at any time.

☑ Arch Linux installation script.

Fully automated script that installs Arch Linux from scratch and configures it exactly as I like.

☑ btrfs snapshots for easy system recovery.

Snapshots are automatically taken before and after each pacman transaction for easy system recovery.

Usage:

$ git clone https://github.com/maximbaz/dotfiles.git ~/.dotfiles
$ ~/.dotfiles/setup-system.sh
$ ~/.dotfiles/setup-user.sh

System recovery

In case system doesn't boot:

1. Boot in a recent snapshot that works

2. Make it the default snapshot

   # cd /mnt/btrfs-root/
   # mv root root-bak
   # btrfs subvolume snapshot snapshots/NN/snapshot root
   

3. Reboot