Skip to content

Grab a random image from a list of imgur albums

Notifications You must be signed in to change notification settings

Dwight-D/artthief

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 

Repository files navigation

Art Thief

Simple python program that reads a list of imgur album hashes and downloads a random image from a random album.

Usage

Create config directory and place a list of imgur gallery/album hashes under ~/.config/artthief/albums.conf.

Run with artthief to download a random image from your configured imgur albums. Image will be automatically downloaded and the path to the downloaded file will be output to stdout for redirecting to other apps such as background setters.

This program works nicely together with something like pywal (shoutout to dylanaraps and thanks for a great program!). Example:

wal -i $(artthief) [other options]

Switches:

-c / --clean to clean the image library (delete previously downloaded files) before running.

Configuration

Config file should be stored under ~/.config/artthief/albums.conf The list should contain imgur album hashes separated by newline. I.e. if the imgur link is https://imgur.com/a/A123BC456 the entry should contain only A123BC456

Hey, what's this cool image I downloaded?

Image names have the following format:

datestamp-galleryHash-imageHash-[imageTitleIfItExists].jpg

If the image title doesn't give you a clue you can recreate the link with these hashes and maybe find some more information there.

Problems?

If the script doesn't execute by itself you may need to run it with python /path/to/artthief or edit the shebang at the start of the script.

Feel free to open an issue or contact me if you have other issues.

About download location

Images are downloaded to ~/.config/artthief/library by default. This can be overridden with --download-dir / -d /download/path

About

Grab a random image from a list of imgur albums

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages