dotfiles/README.md

How it looks like...

Hyprland & Waybar & Eww

Niri & Quickshell

https://github.com/user-attachments/assets/7e2db305-58bc-4b3d-9c65-7dc0461aead7

Grub menu

Setup Overview

• OS: Archlinux
• WM: Hyprland | Niri
• Bar: Waybar | Quickshell
• Shell: Fish
• Prompt: Oh My Posh
• Terminal: Kitty & Ghostty
• Power Menu: Wlogout
• Colorscheme: Catppuccin Mocha
• App Launcher: Rofi | fuzzel
• Desktop Widgets: Eww | Quickshell
• Wallpaper Daemon: Swww
• Notification Daemon: Mako | Quickshell

(bold: currently preferred)

Hyprland & friends

Based on an old version of end-4/dots-hyprland but without ags, quickshell, eww and tons of other stuff.

Niri

Ported from Hyprland, and shares some of the desktop components such as hyprlock & hypridle, but uses quickshell as bar / desktop widgets / notification daemon / ...

Quickshell

Not based on, but heavily depends on many modules from noctalia-shell. A thousand thanks to their great work.

This setup is currently only adapted for Niri.

Eww

• main, main dashboard, modified from syndrizzle/hotfiles but without notification center.
• lyrics, scrolling lyrics player, depends on a small utility from myself (which also happens to be my frist Golang program :D).
• lyrics-single, similar to lyrics, but only with a single line and can be easily embeded into the status bar.

Swww

The wallpaper will be automatically blurred when there is a window in focus, which is implemented in the wallpaper-daemon script.

This feature is only enabled in Niri. Swww also manages wallpapers of the Hyprland setup, yet only in the regular way.

Wallpaper & Colortheme

The most suitable primary color (or so-called flavor) will be chosen from the Catppuccin Mocha palette and applied to various apps automatically after changing wallpaper. And also:

• wallpaper-chooser to select wallpaper, which implements an Image Carousel with Qt Widgets.
• backgrounds collection for personal use.

Rofi

Based on codeopshq/dotfiles, also serves as the clipboard history browser and emoji picker.

Grub theme

Based on vinceliuice/Elegant-grub2-themes with an illustration from 紺屋鴉江.

MPV

Based on noelsimbolon/mpv-config.

Fonts

including:

• Maple Mono NF CN
• MesloLGM Nerd Font (& Mono)
• WenQuanYi Micro Hei
• Sour Gummy
• Noto Sans
• ...

Some of the Scripts

Tip

Most scripts are placed in the scripts folder.

• config-sync

  creates symlinks in ~/.config/ referring to files and directories in config folder. If there is already a file or directorie or whatever with the same name in ~/config/, it will be moved to ~/.config/config-backup/$(date +%Y%m%d-%H%M%S)/ before a new symlink is created.

• config-switch

  updats configurations of several apps according to the current (or given as parameter) desktop environment. e.g. Niri currently doesn't support blurred windows, so terminal emulators such as Kitty and Ghostty could reduce transparency for better appearences.

• change-colortheme

  changes the colortheme of a number of pre-configured apps. This is done by calling certain scripts that are usually called apply-color.

• wallpaper-daemon & change-wallpaper

  provides wallpaper for both Hyprland and Niri (background and backdrop). It can also automatically set the wallpaper to a blurred version when there is a window in focus, however, this is currently only implemented in Niri.

• ssh-init

  ensures that there is only one valid ssh-agent running at the same time. Useful when creating ssh-agent somewhere else than the login shell scripts or across sessions.

• screenshot

  takes a screenshot, and sends a notification asking whether to edit it by clicking on it. Works on both Hyprland and Niri.

• record-script

  records the screen based on wf-recorder and using av1_nvenc as the video encoder. The default codec parameters will generate a fairly large video file (80 Mbps), a later transcoding is definitly required in this case.