Metadata-Version: 2.0
Name: wonderful-bing
Version: 0.8.0
Summary: A script download Bing's img and set as wallpaper
Home-page: https://github.com/lord63/wonderful_bing
Author: lord63
Author-email: lord63.j@gmail.com
License: MIT
Keywords: bing wallpaper
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: docopt (>=0.6.2)
Requires-Dist: requests (>=2.4.0)

Wonderful\_Bing
===============

|Latest Version| |Build Status| |Platform| |Coverage Status|

::

          __        __   ___  __   ___               __          __
    |  | /  \ |\ | |  \ |__  |__) |__  |  | |       |__) | |\ | / _`
    |/\| \__/ | \| |__/ |___ |  \ |    \__/ |___    |__) | | \| \__>

Intro
-----

Tired of the wallpaper? Let's make the change. This program is to
download Bing's picture and set as wallpaper with a notify to let you
know the story behind the picture.

Requirements
------------

-  Linux platform(Currently support gnome, xfce(thanks to
   `@jokeryu <https://github.com/jokeryu>`__), mate(thanks to
   `@renzhn <https://github.com/renzhn>`__))
-  Python 2.7 && python 3.x
-  Libnotify-bin(for Arch: libnotify)

Install
-------

::

    $ (sudo) pip install wonderful_bing
    $ sudo apt-get install libnotify-bin

Usage
-----

Use ``bing --help`` to get the detailed information.

-  Manually

You need to set a directory(default ``/tmp``)to save the download
pictures, end with '/', specify your desktop\_environment(support gnome,
cinnamon, xfce4).

::

    $ bing set -d /path/to/save/pictures/ desktop_environment

-  Automatically(recommand)

1. Add it to ``startup application``\ (in my Linux Mint16) if you power
   on your pc and power off your pc regularly, then every time you boot
   up your pc, this script will automatically run for you.

2. Or use ``cron``. Let me give you an example:

   ::

       0 8 * * * env DISPLAY=:0 /usr/local/bin/bing set -d /home/lord63/pictures/bing/ cinnamon

*we need ``env DISPLAY=:0``, otherwise the notify can't display at all,
and remember the ``/`` at the end.*

3. Or use ``anacron`` if you ofen hang up your pc instead of powering
   off it. but the original ``anacron`` will run the script in root,
   thus it may fail in setting the picture to wallpaper. Follow
   `this <http://www.wellengang.ch/?p=135>`__ to let you run ``anacron``
   as normal user. Let me give you an example, add the following line in
   ``$HOME/.anacron/anacrontab``:

   ::

       1 1 bing env DISPLAY=:0 /usr/local/bin/bing set -d /home/lord63/pictures/bing/ cinnamon

If you find a better way, please let me know :)

Snapshots
---------

the first time you run it:

::

    $ bing set -d /home/lord63/pictures/bing/ cinnamon
    Successfully download the picture to --> /home/lord63/pictures/bing/CascadePools.jpg
    Successfully set the picture as the wallpaper. :)

get today's picture story.

::

    $ bing story
    美国蒙大拿州的白鱼市，正在吃花楸浆果的太平鸟 (© Chuck Haney/Alamy)

if the picture has been downloaded before:

::

    $ bing set -d /home/lord63/pictures/bing/ cinnamon
    You have downloaded the picture before.
    Have a look at it --> /home/lord63/pictures/bing/CascadePools.jpg

if your pc doesn't connect to the network, it will try again after 5
mins.

::

    $ bing set -d /home/lord63/pictures/bing/ cinnamon
    ConnectionError,check your network please.
    Will try again after 5 minutes.

and the notify should looks like this:

.. figure:: ./wonderful_bing/img/notify.png
   :alt: 

License
-------

MIT License

.. |Latest Version| image:: http://img.shields.io/pypi/v/wonderful_bing.svg
   :target: https://pypi.python.org/pypi/wonderful_bing
.. |Build Status| image:: https://travis-ci.org/lord63/wonderful_bing.svg
   :target: https://travis-ci.org/lord63/wonderful_bing
.. |Platform| image:: http://img.shields.io/badge/Platform-Linux-blue.svg
.. |Coverage Status| image:: https://img.shields.io/coveralls/lord63/wonderful_bing.svg
   :target: https://coveralls.io/r/lord63/wonderful_bing


