Cleantoots - Clean Your Toot History

Since I consider my messages on social media to be valid at the moment they're posted, I like to have them deleted after some time. When I still used Twitter, I also used a CLI tool called cleantweets that helped with this.

A few months ago, after having created an account on Fosstodon, I wrote a simple command line utility to help you achieve the same thing but with toots: cleantoots (notice how much effort I put into naming it).

As with most of my side-projects, the code source is released under a free software and open source license, here I used the GPL-3.0.

Since it's written in Python, I also released a Python package to help with the installation process, so a simple python -m pip install cleantoots should do the trick. The rest of the configuration and setup process can be found in the project's README.

You can easily configure the tool to:

  • Delete old toots
  • Keep popular toots (with a minimum number of favorites/boosts)
  • Keep toots given their ID
  • Keep toots containing a hashtag (recent addition)

And as Mastodon is a federated social network and you may have multiple accounts on multiple instances, the configuration file allows that too.

I think the project is usable but it may be improved at least in two ways:

  • Increase the test coverage
  • Refactor the code to make it clearer and add some comments to help contributors

Please don't hesitate to open an issue on the repository or contact me if you have any question, need help using it, find a bug or request a feature! ๐Ÿ˜€

I wrote this as part of 100DaysToOffload, this is the 8th post.

Keywords/tags: #100DaysToOffload #cleantoots #


No reaction yet, write your own!

Will be displayed with your comment.

Not mandatory, fill only if you want me to be able to contact you. It will never be displayed here nor shared with any third party.

Your comment, limited to 500 characters. No formatting.

Your comment may not be approved if it's not respectful, on topic or spammy. If you feel I've made a mistake with your comment, please send me a message!