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 "tweets.csv" that 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.csv 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 CSV file.
php ./deltwitter.php "<path to tweets.csv file>" ("<tweet id to resume>")
Things to note
- This script contains a super-duper hand-written top-down parser for CSV files that uses a single look-ahead character and which does NOT care to handle any corner cases except multi-line values and escaped quotation marks. If this CSV parser fails for you, you are totally free to fix it for your special cases. You have been warned.
- 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-2019, Yahe
All rights reserved.