Package: cleantoots
CleantootsCleantoots helps you delete your old toots. Because not everything we say on social medias should stay there for eternity.Useful links:my blog post introducing cleantoots.The authoritative source for this repo:https://git.augendre.info/gaugendre/cleantootsThe GitHub repository for CI/CD and visibility:https://github.com/Crocmagnon/cleantootsInstallUsing pippython-mpipinstallcleantootsArchLinux packageAn ArchLinux package is available, see theAUR.ConfigInitial setupOnly oncecleantootsconfigsetup# See the following section for config file optionscleantootsconfigloginView and editYou can later view the parsed config file withcleantootsconfiglistYou can edit the config file usingcleantootsconfigeditThis will open the config file using your preferred editor (EDITORenv variable).Config options# Any key in this section will serve as a default for other sections[DEFAULT]# Toots that have at least this number of boosts won't be deleted.boost_limit=5# Toots that have at least this number of favorites won't be deleted.favorite_limit=5# Toots that are more recent than this number of days won't be deleted.days_count=30# The timezone to use for dates comparisons.timezone=Europe/Paris# Each section represents an account.[Fosstodon]# Your Mastodon server URL.api_base_url=https://fosstodon.org# These files are used to store app information obtained when running `login`.# The files must be different between accounts. Two different files are required per account.app_secret_file=fosstodon_app.secretuser_secret_file=fosstodon_user.secret# IDs of toots you want to protect (never delete).# You can find the toot ID in the URL when viewing a toot.protected_toots=103362008817616000103361883565013391103363106195441418# Tags you want to protect (never delete).# Tags are matched case insensitively and are only matched for original toots (not for boosts):# if you boost a toot containing #ScreenshotSunday it won't be protected by this rule.# You MUST omit the `#` part of the tag.protected_tags=100DaysToOffloadscreenshotsunday# Another account[Mastodon.social]api_base_url=https://mastodon.socialapp_secret_file=mastodonsocial_app.secretuser_secret_file=mastodonsocial_user.secret# Overriding some defaultsboost_limit=10favorite_limit=30days_count=7RunSeecleantoots configfor the current config.cleantootsclean# Defaults to a dry run. Does NOT delete.cleantootsclean--delete# Delete without prompt.Add an accountcleantootsconfigedit# Opens editor so you can add your configcleantootsconfiglist# Check your newly added accountcleantootsconfiglogin--only-missing# Store credentials for your newly created accountcleantootsclean--deleteRemove an account# This deletes stored credentials for accounts described in the main config file.cleantootsconfigclear-credentials# You can then edit the config and remove some accounts:cleantootsconfigedit# Then login again for remaining accounts.cleantootsconfigloginTested environmentsCleantoots test suite runs on Python 3.7, 3.8 and 3.9
on latest versions of macOS, Windows and Ubuntu as GitHub Actions understands it.Seethe docsfor more information on what "latest" means.Similar projectsephemetoot: A similar python-based CLI program to delete your old toots. Has
the ability to archive deleted toots.InspirationThe idea behind cleantoots is highly inspired bymagnusnissel/cleantweets.