Metadata-Version: 2.4
Name: paprwall
Version: 2.0.1
Summary: Modern Desktop Wallpaper Manager with Motivational Quotes
Author-email: riturajprofile <riturajprofile@gmail.com>
License: CC BY-NC 4.0
Project-URL: Homepage, https://github.com/riturajprofile/paprwall
Project-URL: Repository, https://github.com/riturajprofile/paprwall
Project-URL: Documentation, https://github.com/riturajprofile/paprwall#readme
Project-URL: Bug Tracker, https://github.com/riturajprofile/paprwall/issues
Project-URL: Changelog, https://github.com/riturajprofile/paprwall/releases
Keywords: wallpaper,desktop,gui,quotes,automation,linux,windows
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Multimedia :: Graphics :: Viewers
Classifier: Environment :: X11 Applications
Classifier: License :: Free for non-commercial use
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: Pillow>=10.0.0
Requires-Dist: pystray>=0.19.0
Provides-Extra: build
Requires-Dist: pyinstaller>=5.0; extra == "build"
Requires-Dist: cx-freeze>=6.0; extra == "build"
Requires-Dist: build; extra == "build"
Requires-Dist: twine; extra == "build"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: types-requests; extra == "dev"
Dynamic: license-file

# PaprWall 🎨

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

[![Version](https://img.shields.io/badge/version-1.1.1-blue.svg)](https://github.com/riturajprofile/paprwall/releases)
[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC--BY--NC%204.0-blue.svg)](https://creativecommons.org/licenses/by-nc/4.0/)
[![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows-lightgrey.svg)](https://github.com/riturajprofile/paprwall)

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)
```bash
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](https://github.com/riturajprofile/paprwall/releases/latest)
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](paprwall/docs/installation.md)
- Usage: [paprwall/docs/usage.md](paprwall/docs/usage.md)

## 🤝 Contributing

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

## 💬 Support

- **Issues**: [GitHub Issues](https://github.com/riturajprofile/paprwall/issues)
- **Releases**: [Latest Version](https://github.com/riturajprofile/paprwall/releases/latest)


---

⭐ Star this repo if you like it! • Made with ❤️ by [riturajprofile](https://github.com/riturajprofile)
