Metadata-Version: 2.1
Name: wallgen
Version: 0.2
Summary: A wallpaper generator for gnome (and kde)
Home-page: https://github.com/hobbypunk90/wallgen
Author: Marcel Hoppe
Author-email: hoppe.marcel@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: X11 Applications :: Gnome
Classifier: Environment :: X11 Applications :: KDE
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE.md

# WallGen - A random wallpaper generator

## Summary

WallGen is a tool to generate wallpapers matching to your display configuration.

## Restrictions

* Needs a mutter based desktop, for example GNOME,
because WallGen reads the display configurations from mutter's DBus service.

## Requirements

* `python >= 3.6`
* `dbus`
* `glib`
* `imagemagick`
* `wand`, http://wand-py.org/
* `python-pydbus`
* `python-gobject`

## Usage

For a new wallpaper from \$HOME/Pictures/Wallpapers, run:
````
$ wallgen
````

For a new wallpaper from reddit, run:
````
$ wallgen -t reddit
````

For more options, run:
````
$ wallgen -h
````

## Advanced Usage

You can run WallGen as DBus service:
````
$ wallgen --dbus
````

After this every new execution of WallGen will use this service to create new wallpaper.
With WallGen as DBus service you can start it also as monitor for display changes:
````
$ wallgen --monitor
````
Whenever the configuration of your displays changes WallGen generates a matching wallpaper for you.

To stop the DBus service and the monitor, run:
````
$ wallgen --quit
````



