https://github.com/fisadev/twistorpy

Twitter history backup tool
https://github.com/fisadev/twistorpy

Last synced: 4 months ago
JSON representation

Twitter history backup tool

• Host: GitHub
• URL: https://github.com/fisadev/twistorpy
• Owner: fisadev
• Created: 2012-07-12T16:27:37.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2016-12-01T22:57:27.000Z (over 7 years ago)
• Last Synced: 2024-01-16T00:41:12.504Z (6 months ago)
• Language: Python
• Size: 22.5 KB
• Stars: 3
• Watchers: 4
• Forks: 8
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst

Lists

• awesome-twitter-tools - twistorpy - Simple command-line tool / python module that allows you to make a backup of the tweets of a twitter user on a json file. (Tools)

README

        
Twistorpy

=========

Twitter history backup tool

Simple command-line tool / python module that allows you to make a backup of the tweets of a twitter user on a json file. The user must have his tweets public.

Because of twitter api limits, each time you run the backup it will fetch tweets until the 3200th tweet is reached (from newer to older), and store them with the already backuped tweets. Plus you can fetch those tweets of which you know the tweet id.

Also, you can stop the running backup with ``Ctrl+c``, and the backup won't be corrupted. After that you could re-run the backup and it will add only the non-added tweets.

Basic usage

===========

First, register your app on `the twitter developers site `_ and fill the settings on the ``twistorpy.py`` file:

.. code::

    CONSUMER_KEY = ''

    CONSUMER_SECRET = ''

    ACCESS_TOKEN = ''

    ACCESS_TOKEN_SECRET = ''

Then just run:

``python twistorpy.py TWITTER_USER HISTORY_FILE_PATH [EXTRA_IDS_FILE_PATH]``

* **HISTORY_FILE_PATH**

Is the path for the json file. If the file doesn't exist, it will be created,

if it already exists, only new tweets will be added to the file.

* **EXTRA_IDS_FILE_PATH (optional)**

You can create a txt file with tweets ids, and those tweets will be downloaded

and added to the history if they don't exist.

(each line of the file must be a different tweet id)