Skip to content
Newer
Older
100644 50 lines (34 sloc) 1.7 KB
a7051e7 @ept Readme & license
authored Feb 5, 2012
1 CoTweet Exporter
2 ================
3
4 [CoTweet Standard Edition](http://standard.cotweet.com/), a Twitter client for businesses,
5 is being [shut down](http://pages.exacttarget.com/socialengagefaq) on 15 February 2012.
6
7 Irritatingly, CoTweet [are not providing](https://twitter.com/cotweet/status/165208168912261120)
8 a way to export the data from your account. (Not cool, if you ask me.) This little Ruby
9 application fills that gap.
10
11
12 Features
13 --------
14
15 * Download the entire contents of your inbox, sent folder and archived messages folder
16 to JSON files on your disk.
17 * For every Twitter user you've communicated with, dumps the conversation history
18 with that user. (This is CoTweet's best feature, because you can avoid getting
19 embarrassed by saying the same thing again to the same person.)
20 * ROFLscale concurrency using asynchronous network I/O. (Not that it was needed, of
21 course -- I just felt like writing it with
22 [em-http-request](https://github.com/igrigorik/em-http-request) and
23 [DG](https://github.com/samstokes/deferrable_gratification).)
24 * Automatic retry of failed requests, to cope with CoTweet's loltastic API.
25
26 The JSON files are in the schema used by CoTweet's internal API. They are not documented,
27 but the format is pretty self-explanatory.
28
29 To my knowledge, there aren't yet any tools to import this data (though of course you can
30 grep through it if you need to). Let me know if you write something that uses the data.
31
32
33 Usage
34 -----
35
36 $ git clone https://github.com/ept/cotweet-export.git && cd cotweet-export
37 $ gem install bundler && bundle install
38 $ mkdir conversations
39 $ bin/cotweet-export
40
41 Tested with Ruby 1.9.2.
42
43
44 License
45 -------
46
47 MIT License (see LICENSE).
48
49 Patches and pull requests welcome.
Something went wrong with that request. Please try again.