TWDLT

Keep your Twitter feed tidy

TWDLT is a simple Python script to automatically delete any tweets older than a certain date. You can set separate "expire" times for normal tweets and @replies. The script can be run continuously with something like Supervisord or one time with something like CRONd or Jenkins.

TWDLT uses a JSON configuration file, you need to be able to locate and provide a consumer key, consumer secret and the linked access token and access token secret from Twitter.

Configuration format

Configuration files are simple JSON files containing the information needed to run the application. Provide the --config or -c flag to twdlt to specify the config file location. There are a number of different options you can provide in the config file

age - default: 24 - tweets will be deleted after this many hours
atAge - @replies will be deleted after this many hours. If not provided age is used
perPage - default: 150 - number of tweets fetched per page*
maxPage - default: 5 - maximum number of pages to fetch*
useLimit - default: 0.25 - maximum % of rate limit for a resource that will be used
every - default: 60 - how often to check for tweets to delete, in minutes. Not used if running as --cron
exclude - List of Python formatted Regex's, any tweets that match any regex will use atAge instead of age

You must also supply

consumerKey
consumerSecret
accessToken
accessSecret

containing your Twitter API credentials in order for the application to work.

* the maximum results that can be returned from Twitter is 800. so perPage multiplied by maxPage should be <= 800

Be aware there are twitter API limits, so if you have a lot of tweets to delete it may take a while. The application will never go over it's specified useLimit and will wait until the rate limit resets before continuing.

Installation

To install the software, run pip install -r https://raw.github.com/samarudge/twdlt/master/requirements.txt --upgrade. It's recommended you install within a virtualenv.

Running

To run the software execute twdlt --config=[path to your config file]

To run in CRON mode execute twdlt --config=[path to your config file] --cron

For a list of options run twdtl --help

Licence

This software is licensed under the GPLv3.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

YoSmudge / twdlt