paprwall 2.0.1

Modern Desktop Wallpaper Manager with Motivational Quotes

PaprWall 🎨

Modern desktop wallpaper manager with inspirational quotes and one-click apply.

Beautiful wallpapers with inspirational quotes. Auto-rotation, 6 quote categories, and a clean dark UI. Robust cross-desktop wallpaper setting with detailed debug logs.

✨ Features

• 🎨 Modern dark UI with large preview
• 💭 6 quote categories: Motivational, Math, Science, Famous, Tech, Philosophy
• 🔄 Auto-rotation with live countdown; interval changes take effect immediately
• 🔕 Background mode - Minimize to tray, auto-rotation continues!
• ✅ "Applied" indicator shows when the preview matches the current wallpaper
• ♻️ Fallback to previously applied wallpaper if a fetch fails
• 📜 History gallery with quick "Set" from any past wallpaper
• 🖥️ Multi-desktop support: GNOME, KDE, XFCE, Cinnamon, MATE, LXQt; feh fallback
• 🧰 Detailed debug logs for wallpaper setting (per-desktop methods and fallbacks)
• 🌐 Random images from multiple APIs + 📁 use your own images with quotes

🚀 Installation

PyPI (Recommended)

pip install paprwall
paprwall-setup-desktop  # Creates desktop/start menu entry
paprwall-gui           # Launch

Linux Packages

• .deb: sudo dpkg -i paprwall_*.deb
• .rpm: sudo dnf install paprwall_*.rpm
• AppImage: chmod +x PaprWall-*.AppImage && ./PaprWall-*.AppImage

Windows

1. Download .zip from Releases
2. Run INSTALL.bat (creates Desktop + Start Menu shortcuts)
3. Launch from Desktop or Start Menu

Requirements

• Python 3.9+ | Linux: sudo apt install python3-tk

🧪 Quick start

1. Select a quote category
2. Click “Random” or “Refresh” to fetch
3. Preview updates with shrink‑to‑fit quote overlay (top‑right)
4. Click “Set Wallpaper” to apply
5. Toggle “Auto‑rotate” and choose an interval
6. Use “History” to re‑apply previous wallpapers

📖 Usage

1. Select Quote Category - Choose from 6 types (Motivational, Math, Science, etc.)
2. Fetch Wallpaper - Click "Random" or "Refresh" button
3. Preview - View wallpaper with embedded quote
4. Set Wallpaper - Apply to desktop
5. Auto-Rotate - Enable timer for automatic changes (continues in background!)
6. History - Browse and reuse previous wallpapers

Background Mode

• Enable "Auto-rotate" + "Minimize to tray"
• Close window → PaprWall runs in system tray
• Auto-rotation continues even when window is closed!
• Right-click tray icon to show window or quit

Data locations

• Linux: ~/.local/share/paprwall/wallpapers/
• Windows: %APPDATA%\PaprWall\wallpapers\

🔧 Troubleshooting

GUI won't start? Install Tkinter: sudo apt install python3-tk (Linux)
Wallpaper not changing? Check supported desktop: GNOME, KDE, XFCE, MATE, Cinnamon, LXQt
Windows SmartScreen? Click "More info" → "Run anyway"

See the docs for more:

• Installation: paprwall/docs/installation.md
• Usage: paprwall/docs/usage.md

🤝 Contributing

git clone https://github.com/riturajprofile/paprwall.git
cd paprwall
pip install -e ".[dev]"

💬 Support

• Issues: GitHub Issues
• Releases: Latest Version

---

⭐ Star this repo if you like it! • Made with ❤️ by riturajprofile