Skip to content

Jeetski/walltext

Repository files navigation

Walltext

Walltext

Tiny Windows-first CLI for turning text into a screen-sized PNG wallpaper.

Python Version MIT License Open Source Hivemind Studio


Walltext lets you rapidly generate beautiful desktop wallpapers from plain text or Markdown right from your terminal. It includes rotating background schedules, hot-reloading watchers, and a fully featured Desktop GUI management tool.

Walltext is free and open-source under the MIT License.

✨ Features

  • Text & Markdown: Support for standard text, or robust Markdown with custom frontmatter, built-in themes ([poster, terminal, note]), and BBCode colors ([color=#ff0000]red[/color]).
  • Rich Manager GUI: Easily manage, organize, design, and edit your wallpaper rotation through the native desktop interface.
  • Smart Sizing: Automatic image sizing pulled directly from your primary display resolution.
  • Watch & Listen: Re-apply wallpapers dynamically from a changing file (walltext watch) or cycle silently through a list on an interval schedule (walltext listen).

🖼 Gallery

Manager GUI

Manager GUI - List Mode Manager GUI - Markdown Mode

Wallpaper Use Cases

Daily Schedule Seneca Quote
Schedule Quote
Sprint Board World Clock
Sprint World Clock
System Metrics Git Quick Reference
Metrics Git Ref
Focus Note ASCII Art
Focus ASCII

🚀 Quick Start

Installation

Use our interactive Windows installer to gracefully install dependencies, add to your PATH, and build your local workspace:

.\install_dependencies.bat

Or if you prefer pip directly:

pip install -e .

Try it out!

Generate your first wallpaper simply by running:

walltext text "Build complete."
walltext md apply today.md

Or open the graphical manager to configure your rotators:

walltext manager

📚 Documentation

Topic Description
💻 CLI Reference Learn how to trigger walltext via terminal commands.
🖼 Manager GUI Learn how to use the graphical configurations, list, and markdown editors.
📝 Markdown Syntax Explore the supported tags, frontmatter theme properties, and styling features.

📄 License

Walltext is released under the MIT License. Free to use, modify, and distribute.


Created with 🤍 by Hivemind Studio Hivemind Studio