🌌 hyprthemer

A sleek and interactive CLI tool to search, install, and rollback Hyprland desktop themes.

Stop manually editing symlinks. Manage your Hyprland rice with elegance.

✨ Features

• Interactive TUI: Beautiful step-by-step menus powered by @clack/prompts.
• Theme Store: Instantly search and download verified Hyprland configurations.
• Fast & Safe: Written in modern Node.js, uses smol-toml for blazing fast config parsing.
• Rollback System: Made a mistake? Revert to your previous configuration with a single command.

🚀 Installation

📋 Requirements & Compatibility:

• hyprthemer is a platform-independent Node.js tool and can run on any Linux distribution.
• However, it is specifically tailored for Hyprland composite manager environments. It is highly recommended to use it on Arch-based distributions, as most Hyprland themes and components (eww, waybar, specialized fonts) are more easily accessible via pacman and AUR.
• Make sure you have Node.js installed on your system.

Arch:

sudo pacman -S nodejs

Then run:

npm install -g hyprthemer

🛠️ Usage

Simply run the tool in your terminal to open the interactive wizard:

hyprthemer --help

How to upload your theme?

Goto hyprthemer-registry, and read README.md

CLI Arguments

You can bypass the interactive menu by using direct commands:

# Search for a theme
hyprthemer search <theme-name>

# Install a specific theme
hyprthemer install <theme-name>

# Rollback to the previous configuration
hyprthemer rollback

📦 Dependencies

hyprthemer is built with minimalism in mind and relies only on a few high-quality packages:

• cac — Configuration-driven CLI apps parser
• @clack/prompts — Beautiful terminal prompts
• picocolors — Tiny terminal text coloring
• fs-extra — Better file system methods
• smol-toml — Fast and small TOML parser

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.