Skip to content
Command-line program that downloads liked posts from Tumblr.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A command-line program for downloading liked posts from Tumblr.

Example of exported HTML


Download the latest release for your platform.

Or, using cargo:

$ cargo install tumblr-likes


In order to download liked posts, you will need an API key. Your blog must be configured to share likes publicly, this can be done by going to your blog's "edit appearance" menu.

  1. Register an application with the Tumblr API. The name and other options don't matter.
  2. Click "Expore API" under the application you just created
  3. Click "Allow"
  4. In the upper right, click "Show Keys"
  5. Copy the API key shown


On the command line:

$ tumblr-likes -a <api_key> -b <blog>

To export posts to html:

$ tumblr-likes -a <api_key> -b <blog> --export likes.html

If you don't want to provide the API key every time, you can save it into an environmental variable $TUMBLR_API_KEY instead.

By default, liked posts will be downloaded into a downloads folder in the current directory. You can use -d to set a custom output directory.

This is very similar to a Node.js package I created a few years ago. I noticed it was getting an surge of installs recently, most likely because Tumblr decided to ban adult content. That package doesn't work anymore though, so I rewrote it in Rust. If you were trying to use that package, sorry.

You can’t perform that action at this time.