Metadata-Version: 2.1
Name: wanda
Version: 0.58.6
Summary: Set wallpapers with keywords or randomly
Home-page: https://gitlab.com/kshib/wanda
License: MIT
Keywords: wallpaper,reddit,wallhaven,unsplash,termux
Author: kshib
Author-email: ksyko@pm.me
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: Pillow (>=9.1.0,<10.0.0)
Requires-Dist: cloudscraper (>=1.2.60,<2.0.0)
Requires-Dist: lxml (>=4.8.0,<5.0.0)
Requires-Dist: requests (>=2.27.1,<3.0.0)
Project-URL: Bug Tracker, https://gitlab.com/kshib/wanda/-/issues
Project-URL: Repository, https://gitlab.com/kshib/wanda
Description-Content-Type: text/markdown

# wanda
Script to set wallpaper using keyword or randomly

![Codacy branch grade](https://img.shields.io/codacy/grade/e5aacd529ce04f3fb8c0f9ce6a3bdd9e/main)
![PyPI](https://img.shields.io/pypi/v/wanda)
![PyPI - Downloads](https://img.shields.io/pypi/dw/wanda)
![PyPI - License](https://img.shields.io/pypi/l/wanda)

## Installation
```
pip install wanda
```
or `pip install -i https://test.pypi.org/simple/ wanda` for dev version

## Usage
```
wanda
wanda -t mountain
wanda -s wallhaven -t japan
```
`wanda -h` for more details

## Notes
- By default the source is [unsplash](https://unsplash.com).
- Some sources may have inapt images. Use them at your own risk.

## Supported sources

- [4chan](https://boards.4chan.org)
- [500px](https://500px.com)
- [artstation](https://artstation.com)
- [imgur](https://imgur.com)
- local
- [reddit](https://reddit.com)
- [unsplash](https://unsplash.com)
- [wallhaven](https://wallhaven.cc)

# Demo
- [Desktop, Manjaro Linux](https://z.zz.fo/om26p.webm)

## Automate
* To set wallpaper at regular intervals automatically:

0. Install (for android only):
```
termux-wake-lock
pkg in cronie termux-services nano
sv-enable crond
```
1. Edit crontab
```
crontab -e
```
2. Set your desired interval. For hourly:
```
@hourly wanda -t mountains
```
[(more examples)](https://crontab.guru/examples.html)

4. ctrl+o to save, ctrl+x to exit the editor

## Build
[python](https://www.python.org/downloads/) and [poetry](https://python-poetry.org/) are needed
```
git clone https://gitlab.com/kshib/wanda.git && cd wanda
poetry build
```

## Uninstall
```
pip uninstall wanda
```

## Shell
Older versions can be found [here (android)](https://gitlab.com/kshib/wanda/-/tree/sh-android) and [here (desktop)](https://gitlab.com/kshib/wanda/-/tree/sh-desktop)
They support [canvas](https://github.com/adi1090x/canvas/blob/master/canvas) and [earthview](https://earthview.withgoogle.com/) as source which have not yet been added to python version.

## Issues
There might be issues with certain sources or platforms.
For now, the script is only tested on Manjaro+KDE and Android+Termux
Feel free to raise issues if you encounter them.

## License
MIT

