Save content from list of tweet URLs to an HTML file
CSS Ruby HTML Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Static Tweets allows you to back up the content of tweets (text + images + associated metadata) to an HTML file that you can keep for your personal reference.

It's a command-line tool written in Ruby and requires Rubygems and Bundler. Rbenv or a tool that uses the .ruby-version file is recommended to ensure ruby version compatibility.

In order to use the tool, you'll first need to generate an 'application' on the Twitter Application Management page ( and put your OAuth keys into a .env file in the root of your locally cloned repo. The following key/value pairs are required:


You can optionally add the following key/value pairs in order to enable certain features:


There are a number of commands you can then use to download your tweet backup, depending on the source you want to use:

./ <url>
./ <url>
./ <text_file>

The result is a directory named to match the supplied text filename. Inside the directory is a JSON file with each tweet's full data as supplied by Twitter, corresponding images for any tweets that include media, and an index.html file that shows you the tweets in an embed-like view.

Please note that some websites have fancy features like infinite scroll that may hide a bunch of tweets from being displayed until a user interacts with the page in some way. If a page works this way, the command that takes a single URL will not work reliably and you'll have to compile a list of tweet ids in a file manually or via some other method. (This includes Storify URLs; use the from_storify command for those)

If for some reason you want to run the command on the same text file twice, you'll need to delete the directory before running again.