This script is a one-off approach to deleting all tweets and retweets ever done on twitter by a given user account. It uses the TwitterOAuth library to access the official Twitter API.
- Log in to twitter.com and visit developer.twitter.com/en/apps.
- Click on
Create New Appand enter the requested, mandatory information, agree to the Twitter Developer Agreement and click on
Create your Twitter application.
- Visit the
Keys and tokenstab and note the
API secret keyvalues in the
Consumer API keyssection for the configuration of this script.
- Scroll down to the
Access token & access token secretsection and click on
Create. Note the
Access token secretvalues for the configuration of this script.
- Enter the folder in which you downloaded this script with a command shell and execute
composer require abraham/twitteroauthto install the TwitterOAuth library.
config.phpand configure the script.
- Then you will have to request your Twitter archive through your account settings page. It may take a while until you receive the corresponding download link.
- The Twitter archive contains a file called
data/tweets.jsthat you have to use as the first parameter for the script.
- Now you can execute the script by calling it and providing the path to the tweets.js file along. Depending on the number of tweets and retweets you have this process may take a while.
- The tweet id of every deleted tweet and retweet is printed to the screen.
- Should it be necessary to abort the process and resume later, you should save the last processed tweet id.
- You can use a tweet id as an optional second parameter so that the deletion can proceed with the next tweet or retweet in the JS file.
./deltwitter.php "<path to tweets.js file>" ("<tweet id to resume>")
In case you have posted a lot of tweets and get a memory-exhaustion error you can start the script with more assigned memory like this:
php -d memory_limit=2048M ./deltwitter.php "<path to tweets.js file>" ("<tweet id to resume>")
If you want to know which IDs are contained in the file and which creation date they have then provide a non-numeric tweet ID as a second parameter.
Things to note
- This script was written with the intention to be a lowest-effort approach to automating the deletion of tweets and retweets. If it breaks anything, it is up to you to fix it. There will be absolutely no support given to anyone using this script. You have been warned.
- It seems to be impossible to delete retweets of people that have set their accounts to protected after retweeting them, unless you follow them.
- The Twitter API runs into timeouts from time to time leading to an exception in the TwitterOAuth library. Just restart the script with the last tweet id. The resume feature is fast enough.
This application is released under the MIT license. See the LICENSE file for further information.
Copyright (c) 2016-2022, Yahe
All rights reserved.