paprwall 2.1.0

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 - Run as systemd service (Linux) or Windows startup
• ✅ "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 (Daemon)

Linux (systemd service):

paprwall-service install   # Install and start service
paprwall-service status    # Check status
paprwall-service uninstall # Remove service

Service runs in background, auto-rotation continues even after logout!

Windows (Startup):

paprwall-service install   # Add to Windows Startup
paprwall-service uninstall # Remove from Startup

PaprWall starts automatically when you log in.

Manual daemon mode:

paprwall-gui --daemon      # Run in background (no window)

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