Twitter Cleaner
Twitter rolls out new API access tiers which means that migration to v2 is needed. Free tier doesn't offer all the capabilities needed for
twitter-cleaner
to function properly.Basic tier has all the needed APIs but it starts at $100/month which is ridiculous and I'm not interested to pay so much to clean my feed. This is the reason why this repo is archived.
Thanks everyone who used this tool!
Clean your Twitter.
Once in 24 hours all tweets that are older than half a year (by default) will be deleted, un-retweeted and un-favorited from your feed.
Motivation
I observed that tweets liveability is a few days maximum. Why then I need to store them all in my timeline? For me Twitter is a place to interact with others and not to use it as a diary for archeologists.
If you would like to do regular cleanups too, this tool is for you.
Install
Download binary from releases page.
If you have Go:
go get github.com/skibish/twitter-cleaner
Example
$ ./twitter-retention \
-access-token aaa \
-access-token-secret ttt \
-consumer-key kkk \
-consumer-secret xxx
2021/04/25 13:19:53 successfully started
2021/04/25 13:20:52 scanned through 44 timeline tweets
2021/04/25 13:20:52 DELETING XXXXXXXXXXXXXX240
2021/04/25 13:20:52 UNRETWEETING XXXXXXXXXXXXXX624
2021/04/25 13:20:53 scanned through 0 timeline tweets
2021/04/25 13:20:53 scanned through 199 favorite tweets
2021/04/25 13:20:54 scanned through 105 favorite tweets
2021/04/25 13:20:54 UNFAVORITING XXXXXXXXXXXXXX416
2021/04/25 13:20:54 UNFAVORITING XXXXXXXXXXXXXX183
2021/04/25 13:20:54 UNFAVORITING XXXXXXXXXXXXXX100
2021/04/25 13:20:54 UNFAVORITING XXXXXXXXXXXXXX225
2021/04/25 13:20:55 UNFAVORITING XXXXXXXXXXXXXX508
2021/04/25 13:20:55 UNFAVORITING XXXXXXXXXXXXXX317
^C
2021/04/25 13:21:20 shutdown
Usage
./twitter-cleaner:
-access-token string
Access token
-access-token-secret string
Access token secret
-check-interval duration
Cleanup interval (default 24h0m0s)
-consumer-key string
Consumer key
-consumer-secret string
Consumer secret
-dry-run
Check that something can be deleted, no real deletion is made
-tweet-age duration
Tweets older than this duration will be deleted (default 4380h0m0s)
-v Show version
You can find out here how to create all needed tokens.
Development
go get