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.
- 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).
| Daily Schedule | Seneca Quote |
|---|---|
![]() |
![]() |
| Sprint Board | World Clock |
|---|---|
![]() |
![]() |
| System Metrics | Git Quick Reference |
|---|---|
![]() |
![]() |
| Focus Note | ASCII Art |
|---|---|
![]() |
![]() |
Use our interactive Windows installer to gracefully install dependencies, add to your PATH, and build your local workspace:
.\install_dependencies.batOr if you prefer pip directly:
pip install -e .Generate your first wallpaper simply by running:
walltext text "Build complete."
walltext md apply today.mdOr open the graphical manager to configure your rotators:
walltext manager| 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. |
Walltext is released under the MIT License. Free to use, modify, and distribute.










