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 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
is used--cron
atAge
instead of age
You must also supply
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.
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.
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
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/>.