Skip to content

Latest commit

 

History

History
35 lines (20 loc) · 1 KB

README.md

File metadata and controls

35 lines (20 loc) · 1 KB

aww.py

A CLI for adorable pictures.

Usage

Installing is simple.

$ git clone https://github.com/dukerson/aww.py.git
$ cd aww.py/
$ python setup.py install

And then...

$ aww

And then...

A cute lil picture!

To call the Reddit API with your username, use:

$ aww your_username

Requirements

Ability to coo. (Okay, and PIL.)

Points of Notice

The cute images are sourced from Reddit's r/aww subreddit, which is completely wonderful and perfect in every single way. However (and for good reason!) the Reddit API limits requests to around fifty requests an hour; if your cuteness tolerance runs up against this wall, consider calling invoking app.py by appending your username to the script so the request lists your username as a user agent!

This was made by Justin Duke from the College of William & Mary! Feel free to drop him a line.