An automatic image downloader for Tumblr blogs and other image-focused sites. The program uses its own dedicated parser, using web scraping and public API that doesn't require tokens.

This project is built on latest Python 3 version (currently 3.9), which you need in order to test and run this program. Backwards compatibility towards old Python 3 or Python 2 versions is not considered; continue at your own risk.

This project uses python virtualenv for dependency management. This set-up needs to be done only once, and any subsequent python executions are to be done inside the venv. To set up, on the root project directory, run:

virtualenv -p python3 venv

You may also replace venv with the name of your choice. Also replace every subsequent occurrences of venv with your name of choice.

Enter source venv/bin/activate on your terminal to enable virtualenv before proceeding to the next step.

To install dependencies, run:

pip install -r requirements.txt

Note: It is possible to forgo creating virtual environment and install dependencies in your bare OS; However, it is recommended to use virtualenv and install dependencies there, to avoid dependency version conflicts or other complications arising from shared libraries.

Enter virtualenv by entering source venv/bin/activate on your terminal, if applicable. On the root project directory, run python tumbl-down.py [options] <service> <account_id...> (values in <> are mandatory). To see available options, run python tumbl-down.py -h.

Enter virtualenv by entering source venv/bin/activate on your terminal, if applicable. On the root project directory, run python -m unittest <test_package_name>. For example, to run test file test/tumblr_feed.py, run python -m unittest test.tumblr_feed.

This project is licensed under BSD (3-clause).