Skip to main content

A premium terminal wallpaper browser and manager

Project description

ZeroWallpaper

A premium terminal wallpaper browser and manager built with Textual.

Browse, preview, and apply aesthetic wallpapers from D3Ext/aesthetic-wallpapers — all from your terminal.

Features

  • Remote-first: Fetches wallpapers from GitHub without cloning the repo
  • Tag-based filtering: Multi-tag search parsed from repository metadata
  • Terminal image preview: See wallpapers rendered directly in your terminal
  • Cross-platform: macOS, Linux (GNOME/KDE/XFCE), and Windows support
  • Auto-change: Scheduled wallpaper rotation with configurable intervals
  • Favorites & History: Track your favorite and recently applied wallpapers
  • Keyboard-driven: Full keyboard navigation with intuitive shortcuts

Installation

pip install  zerowallpaper

Usage

zerowallpaper

Keyboard Shortcuts

Key Action
↑↓ / j k Navigate wallpapers
Enter Preview wallpaper
s Set wallpaper
v View HD image popup
/ Focus search
Tab Switch panels
r Random wallpaper
a Toggle auto-change
f Toggle favorite
R Refresh index
q Quit

Configuration

Config is stored at ~/.zerowallpaper/config.json. Set GITHUB_TOKEN environment variable for higher API rate limits.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zerowallpaper-1.1.0.tar.gz (22.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zerowallpaper-1.1.0-py3-none-any.whl (33.3 kB view details)

Uploaded Python 3

File details

Details for the file zerowallpaper-1.1.0.tar.gz.

File metadata

  • Download URL: zerowallpaper-1.1.0.tar.gz
  • Upload date:
  • Size: 22.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for zerowallpaper-1.1.0.tar.gz
Algorithm Hash digest
SHA256 47a0e00a75d524a40026ef6410dc7069c28bbf81e8c3b9cd3f62a758c3dee209
MD5 d88e39b029559f6aa142c19166f6d36a
BLAKE2b-256 ba9f9ddea6505957a9a8f92f0f12afa0427a8f73779b74a71a0fa06f5ff4e9f3

See more details on using hashes here.

File details

Details for the file zerowallpaper-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: zerowallpaper-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 33.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for zerowallpaper-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b90987be0914e2c0671a48d5c2673adc50bd25ccc1154554e4d06ae7798bec6c
MD5 587deeed7f2429c12aa3914d89d0d04c
BLAKE2b-256 93b789c38d71fa93ea1713597d460d6694f941f78d16993251f285f73f078177

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page