tumblr-backup 1.3.0

An advanced tool for backing up Tumblr blogs.

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

Installation

1. Install with pip:

   pip install tumblr-backup
   

2. Create a Tumblr app at https://www.tumblr.com/oauth/apps to get an API key

3. Set your API key:

   tumblr-backup --set-api-key YOUR_API_KEY
   

Backup a Blog

To backup a blog, simply run:

tumblr-backup blog-name

For example, to backup staff.tumblr.com:

tumblr-backup staff

This will create a staff/ directory containing:

• An index.html file with links to all posts
• Monthly archive pages
• Individual post pages
• All images and media from the blog

Incremental Backups

To update an existing backup with only new posts:

tumblr-backup -i blog-name

Advanced Features

tumblr-backup supports many advanced features like:

• Backing up videos and audio files
• Saving post notes (likes/reblogs)
• Filtering posts by tag or type
• Dashboard-only blog support
• And much more!

See the detailed documentation for all options and features.

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

Join our Discord community to:

• Get help and support
• Ask questions
• Request new features
• Get notified about new releases
• Share your feedback

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