https://github.com/mortonfox/twstat

Generate Twitter Stats from a downloaded Twitter archive
https://github.com/mortonfox/twstat

chart ruby twitter

Last synced: 10 days ago
JSON representation

Generate Twitter Stats from a downloaded Twitter archive

• Host: GitHub
• URL: https://github.com/mortonfox/twstat
• Owner: mortonfox
• License: gpl-3.0
• Created: 2013-03-13T20:25:31.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2017-06-23T19:36:11.000Z (over 7 years ago)
• Last Synced: 2024-10-23T04:59:10.209Z (14 days ago)
• Topics: chart, ruby, twitter
• Language: Ruby
• Size: 62.5 KB
• Stars: 9
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# twstat - Stats charts from downloaded Twitter archives

## Introduction

In December 2012, Twitter

[introduced](http://blog.twitter.com/2012/12/your-twitter-archive.html) 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 

1. Click on the "Request your archive" button.

1. 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:

* jQuery (from [CDNJS](http://cdnjs.com/))

* [jQCloud](https://github.com/lucaong/jQCloud) jQuery plugin (from [CDNJS](http://cdnjs.com/))

* [Google Chart Tools](https://developers.google.com/chart/)

## 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](https://mortonfox.github.io/twstat/out.html).

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.