This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

# RedditWallpaperChooser

RedditWallpaperChooser will download the trending wallpapers of the day from any subreddit of your choice.

## Features

  • Choose the subreddits you like.
  • Filter by aspect ratio and image size.

## Requirements

We make use of Python’s 3 asynchronous APIs and async/await syntax. For this reason, we only support Python versions ≥ 3.5.

Additional requirements are listed in the requirements.txt file.

## Installation & Usage

Until RedditWallpaperChooser will land on PyPi you can install it as follows:

`bash $ git clone https://github.com/aldur/RedditWallpaperChooser/ $ cd RedditWallpaperChooser $ pip install . .[extras]  # --user could also help you `

You’ll find reddit-wallpaper-chooser in your PATH. You can now start collecting wallpapers.

`bash $ reddit-wallpaper-chooser `

The absolute path of one of the downloaded wallpapers will be printed out to standard output.

### macOS

As a bonus, on macOS, you can set the wallpaper to the one just downloaded for you: `bash $ wall=$(reddit-wallpaper-chooser 2> /dev/null) && osascript -e "tell application \"Finder\" to set desktop picture to POSIX file \"$wall\"" `

_Note_: due to a limitation of the macOS APIs, it will only change the wallpaper of the currently selected space.

## Configuration

You can configure RedditWallpaperChooser by providing a ini configuration file. In it, you can specify the following general options:

  • the subreddits to parse (subreddits)
  • the number of results per subreddit (result_limit)
  • the output directory (output_folder)
  • the subreddit sorting (sorting)
  • a time parameter for ‘top’/’controversial’ sorting (time)

Additionally, you can also filter the candidate wallpapers to be selected and returned at the end of the download process:

  • by aspect ratio (aspect_ratio)
  • by minimum size (size)

Until better documentation will be developed please refer to the default configuration options as a working example; You can dump it as follows:

`bash $ reddit-wallpaper-chooser -d config.ini `

You can then use your configuration with:

`bash $ reddit-wallpaper-chooser -c config.ini `

## Future improvements

  • Filter wallpapers by color.
  • Avoid choosing again the same images.
  • Add a proper test suite.
Release History

Release History

0.2.3

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
RedditWallpaperChooser-0.2.3.tar.gz (9.2 kB) Copy SHA256 Checksum SHA256 Source Sep 1, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting