tumblr-backup

tumblr-backup is a Python tool that backs up your Tumblr blog locally as HTML files, preserving all your posts, images, and media. It creates a beautiful, browsable archive of your blog that you can view offline.

This is a fork of bbolli's tumblr-utils, with added Python 3 compatibility, bug fixes, support for dashboard-only blogs, and many other enhancements.

Quick Start

Step 1: Install Python (if you don't have it)

Windows and macOS: Download and install Python from python.org. During installation on Windows, check the box that says "Add Python to PATH" — this is important!

Linux: Python is usually already installed. You can check by opening a terminal and typing python3 --version.

Step 2: Install tumblr-backup

Open a terminal. Then run the install command for your system:

pip install tumblr-backup

sudo apt install pipx
pipx install tumblr-backup

sudo dnf install pipx
pipx install tumblr-backup

brew install pipx
pipx install tumblr-backup

curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install tumblr-backup

Step 3: Get a Tumblr API key

1. Go to https://www.tumblr.com/oauth/apps (log in if needed)
2. Click Register application
3. Fill in any values for the required fields (the specific values don't matter)
4. Copy the OAuth Consumer Key shown on the next page

Step 4: Save your API key

tumblr-backup --set-api-key YOUR_API_KEY

Replace YOUR_API_KEY with the key you copied.

Step 5: Back up a blog

tumblr-backup blog-name

For example, to back up staff.tumblr.com:

tumblr-backup staff

This will create a staff/ directory in your current folder containing an index.html file you can open in your browser to view the backup, along with monthly archive pages, individual post pages, and all images and media.

Updating an existing backup

To add only new posts to an existing backup:

tumblr-backup -i blog-name

Optional extras

tumblr-backup has optional features you can enable by installing extras. Add them in square brackets after the package name:

pip install "tumblr-backup[video]"

(On Linux/Homebrew, replace pip install with pipx install or uv tool install as above.)

Documentation

• Installation Guide — Detailed installation instructions including optional features
• Usage Guide — Complete list of options and command-line arguments
• Operation Guide — How tumblr-backup works under the hood

Support & Community

If you get stuck, have questions, or want to request features, join the Discord:

Join the Discord server →

Third-party Components

This project redistributes npf2html (MIT) from https://github.com/nex3/npf2html at commit 05d602a.

• Upstream license: see 3rdparty/npf2html/LICENSE.
• Source used to produce the bundled JS: 3rdparty/npf2html/ with build steps in 3rdparty/README.md.

Acknowledgments

• bdoms for the initial implementation
• WyohKnott for numerous bug reports and patches
• Tumblr for their discontinued backup tool whose output was the inspiration for the styling applied in tumblr_backup.
• Beat Bolli