zerowallpaper 1.2.0

A premium terminal wallpaper browser and manager

ZeroWallpaper 🌌

The ultimate terminal-based aesthetic wallpaper engine.

Features • Installation • Usage • Configuration

---

🖼️ Gallery

Experience the fluid UI and high-fidelity rendering

---

✨ Features

• 🌌 Aesthetic-First: Curated wallpapers from the best sources on GitHub.
• 🚀 Streamed, Not Cloned: Zero local storage bloat. We stream only what you want to see.
• 🖥️ High-Fidelity Rendering: Native support for Kitty, WezTerm, and iTerm2 with Chafa fallback.
• ⚡ Turbo Filtering: Instantly search by tags, name, or category with real-time updates.
• 💖 Native Favorites: Keep your favorite aesthetics just one keystroke away.
• 🔄 Smart Auto-Changer: A lightweight background daemon that keeps your desktop fresh.
• 🎹 Keyboard Focused: Designed for power users. No mouse required, but fully supported.

📦 Installation

ZeroWallpaper is just a pip command away:

pip install zerowallpaper

[!TIP] For the best visual experience, install chafa on your system: brew install chafa (macOS) or sudo apt install chafa (Linux).

⌨️ Usage

Launch the engine:

zerowallpaper

🎮 Controls

Key	Action
↑ ↓	Navigate wallpapers
Enter	Preview wallpaper
s	Set wallpaper
Shift + E	Explore All
Shift + C	View Cached
Shift + F	View Favorites
f	Toggle Favorite
a	Toggle Auto-changer
/	Search
Tab	Cycle panels
q	Exit

⚙️ Configuration

ZeroWallpaper keeps things simple. Your config and cache live at ~/.zerowallpaper/.

🔑 GitHub Token (Optional)

To avoid GitHub's unauthenticated rate limits, set a personal access token:

export GITHUB_TOKEN="ghp_your_token_here"

📜 License

Distributed under the MIT License. See LICENSE for more information.

---

Built with 💜 by @shashaaankkkkk

Making the terminal beautiful, one wallpaper at a time.