Skip to content
export a Tumblr tumblelog to disk from the command line
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
README.markdown First go at tumblrout script that authenticates



tumblrout is a command line tool for exporting a Tumblr blog to local files.


Install its dependencies from the requirements.txt file:

$ pip install -r requirements.txt

Then you can install it as any other Python program:

$ python install

If you don't want to install its dependencies system-wide, try installing it in a virtual environment.


First, you'll need a Tumblr API key. Register an application on the Applications page of to get a key. Once you have a key, run the configure command:

$ tumblrout configure
OAuth Consumer Key: 68-A
Secret Key: f73D85A83def7BC29580FEB9f087A69Bc6bfacd1DDDBEBfb2bAF52c1

OAuth Verifier: 13b24c7D485A9C4e99F1B4b163ddAE6eE4b9917e

After entering your secret key, the authorization page should open in your web browser. After approving your app, copy the oauth_verifier from the URL of the resulting page and paste it at the OAuth Verifier: prompt.


See tumblrout --help for supported commands.

$ tumblrout -v verify
INFO: Set log level to INFO
INFO: Verified!

Something went wrong with that request. Please try again.