https://github.com/kyleconroy/grain

The Entire History of You
https://github.com/kyleconroy/grain

archiver facebook twitter

Last synced: 2 months ago
JSON representation

The Entire History of You

• Host: GitHub
• URL: https://github.com/kyleconroy/grain
• Owner: kyleconroy
• License: mit
• Created: 2018-02-18T05:32:39.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2018-07-14T23:34:38.000Z (over 6 years ago)
• Last Synced: 2024-10-15T20:14:54.638Z (2 months ago)
• Topics: archiver, facebook, twitter
• Language: Go
• Homepage:
• Size: 274 KB
• Stars: 35
• Watchers: 5
• Forks: 5
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Grain

The Entire History of You

## Usage

Grain looks for API access keys and secrets in `config.toml`. 

## Twitter

Grain will download a full archive of your Twitter account, unlike the official

Twitter Archive. Your Grain archive includes the following records:

- Direct messages

- Favorites

- Followers

- Friends

- Lists

- Tweets

The archive also includes all media associated with the above records.

For privacy and performance reasons, you'll need to obtain your own API

credentials.

1. Log onto [Twitter](https://twitter.com) with the account you'd like to archive

2. Request your archive from your [Settings page](https://twitter.com/settings/account)

3. Create a new [application](https://apps.twitter.com)

4. Go to the "Keys and Access Tokens" section for your application

5. Generate access tokens via "Create my access token"

6. Fill in `config.toml` with the access and secret tokens

```

[twitter]

username = ""

tweet-csv = "path/to/tweets.csv"

consumer-key = ""

consumer-secret = ""

access-token = ""

access-token-secret = ""

```

Running `grain` will download records to `archive/twitter` in the current

working directory.

### Limitations

The Twitter API has a set of limitations which makes archiving certain records

difficult.

- The API only returns the most recent 3,200 tweets from your timeline. You'll

  need to download your official Twitter Archive for Grain to successfully

archive all of your tweets.

- Only the last 30 days of direct message activity is available via the API.

- Rate limits are very aggressive which means certain records take forever to

  archive.

## Facebook

Coming soon…