Skip to content

mortonfox/twstat

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

twstat - Stats charts from downloaded Twitter archives

Introduction

In December 2012, Twitter introduced a feature allowing users to download an archive of their entire user timeline. By February 2013, it was available to all users.

To request your Twitter archive:

  1. Visit https://twitter.com/settings/account
  2. Click on the "Request your archive" button.
  3. Wait for an email from Twitter with a download link.

twstat is a Ruby script that generates charts from the data in a Twitter archive. The output is in the form of a single web page, ready for hosting or private viewing.

Prerequisites

To run twstat, you need to install the rubyzip gem. Run gem install rubyzip to add it to your Ruby installation.

The generated web page references the following libraries from online sources:

Usage

Run the following command to process your downloaded Twitter archive:

ruby twstat.rb tweets.zip out.html

Then view out.html in a web browser.

If you have already unzipped your Twitter archive, you may also run twstat directly on tweets.csv:

ruby twstat.rb tweets.csv out.html

See a sample output page.

Note: All timestamps in the Twitter archive are in UTC. For the Tweets by Hour chart, twstat uses the system configured timezone to convert those timestamps to local time.

About

Generate Twitter Stats from a downloaded Twitter archive

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published