✧ quantum ✧

Hyprland setup by Ren

Disco Elysium	Hollow Knight
Miku	Outer Wilds
Wallpicker

✦ Features

➢ Dynamic Theming : powered by Pywal. Select a wallpaper and colors instantly bleed into Hyprland, Kitty, Rofi, and Obsidian.

➢ Quickshell UI : a custom, animated QML sidebar for media controls, power profiles, system tools, and draggable screen stickers.

➢ Holograph TUI : a Rust-based terminal interface to browse images and swap your Fastfetch avatar and sticker themes on the fly.

✦ Working File Structure

Here is an example of how your home directory will look once everything is set up.

/home/user/
 │
 ├── 📁 dotfiles/                  # The cloned repository
 │    ├── 📁 logo/holograph/       # Drop your Fastfetch theme folders here
 │    │    ├── 📁 /                # (Holograph themes)
 │    │    └── 📁 myTheme/   
 │    │
 │    ├── 📁 local/                # Hardware & local paths
 │    │    ├── hypr-local.conf     # Local configs
 │    │    └── post-wallpaper.env  # Obsidian vault path
 │    │
 │    └── 📁 ...                   # (Kitty, Rofi, Quickshell, Pywal configs)
 │
 ├── 📁 Pictures/
 │    └── 📁 Wallpapers/           # Drop your wallpapers here
 │                                 
 │
 └── 📁 Documents/
      └── 📁 Obsidian/
           └── 📁 Vault/           # Your personal Obsidian vault
                                   # (CSS snippets are auto-injected here)

✦ Installation

Built exclusively for Arch Linux and its derivatives.

Clone the repository and launch the Installer. Do not run as root.

git clone https://github.com/lorediggia/quantum ~/dotfiles
cd ~/dotfiles
chmod +x install.sh
./install.sh

Existing configs are safely backed up to ~/.config-backup-YYYYMMDD.

✦ Keybinds

SUPER + W	Wallpicker (Select Wallpaper & Apply Theme)
SUPER + X	Toggle Sidebar (Quickshell)
SUPER + Enter	Open Terminal (Kitty)
SUPER + CTRL + Enter	Open App Launcher (Rofi)
SUPER + E	File Manager (Nautilus)
SUPER + B	Web Browser (Zen)
SUPER + S	Interactive Screenshot
SUPER + Q	Close active window

✦ Theming Engine

The system aesthetic is driven by the Wallpicker (SUPER + W).

1. Awww sets the wallpaper with a smooth transition.
2. Pywal extracts the dominant color palette.
3. Templates in pywal/ generate configuration files.
4. Background wal-hooks instantly reload Kitty, Quickshell, and inject the new CSS into your Obsidian Vault.

✦ Holograph

Holograph is a TUI that organizes your Fastfetch stickers into theme folders, letting you swap them on the fly.

➢ Add a New Theme

1. Go to ~/dotfiles/logo/holograph/
2. Create a new directory here (e.g. .../holograph/MyTheme/).
3. Drop your .png, .jpg, or .webp images inside.

➢ Change Cover & Apply Theme

1. Type holograph in your terminal.
2. Use the arrow keys to browse through your folders and images.
3. Press C to set the selected image as your Fastfetch Cover.
4. Press Enter to Apply the theme. Fastfetch updates automatically!

✦ Obsidian Integration

During the Installation, the script will ask for your Vault's location and automatically configure the path in ~/dotfiles/local/post-wallpaper.env.

1. Open Obsidian and navigate to Settings ➔ Appearance.
2. At the bottom of the menu, find the CSS snippets section.
3. Activate pywal.css and layout-obsidian.css.

Every time you use the Wallpicker (SUPER + W), the system generates a fresh palette and pushes it directly into your Vault.

If you move your Vault later, you can simply re-run the installer or update the path in your local/ folder.

✦ Uninstaller

cd ~/dotfiles
./uninstall.sh

Removes symlinks, clears caches, uninstalls downloaded packages, and restores your original backups.

✦ Credits

⋄ WhiteSur GTK

⋄ Bibata Cursors

⋄ Pywal

⋄ awww

"The universe is, and we are."