efemettotoot elimina i toot di Mastodon che sono più vecchi di un certo numero di giorni tranne quelli che:: sono appuntati; includono alcuni hashtag; hanno una certa visibilità; sono elencati individualmente https://mastodon.it
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Hugh Rundle 40582357f2
Merge pull request #80 from hughrun/3-1-4
2 months ago
.github prepare for v3.0.0 3 years ago
docs add archive_media configuration option 2 years ago
ephemetoot remove setuptools runtime dependency 3 months ago
tests mock archive toot media response 2 years ago
.gitignore prepare for 3.1.1 release 2 years ago
CODE_OF_CONDUCT.md update CoC contact email 3 years ago
LICENSE first commit 4 years ago
README.md Use HTTPS URL for link 1 year ago
example-config.yaml add archive_media configuration option 2 years ago
poetry.lock update lock file 2 months ago
pyproject.toml update version number and poetry.lock 2 months ago


🥳 ==> 🧼 ==> 😇

PRs Welcome

ephemetoot is a Python command line tool for deleting old toots.


You should have Python3 and pip installed, and an app access token on hand. More detail information is available in the docs

Install with pip:

pip install ephemetoot

Create a config file:

ephemetoot --init

Do a first run in --test mode:

ephemetoot --test

Find out about other options:

ephemetoot --help


You can also read the docs at ephemetoot.hugh.run

The initial ephemetoot script was based on this tweet-deleting script by @flesueur

ephemetoot relies heavily on the Mastodon.py package by @halcy

Looks like Gabriel Augendre had the same idea. You might prefer to use Gabriel's cleantoots instead.


You can use ephemetoot to delete Mastodon toots that are older than a certain number of days (default is 365). Toots can optionally be saved from deletion if:

  • they are pinned; or
  • they include certain hashtags; or
  • they have certain visibility; or
  • they are individually listed to be kept


ephemetoot is packaged using poetry and tested using pytest.

For all bugs, suggestions, pull requests or other contributions, please check the contributing guide.


This project and all contributions are licensed under the GPL 3.0 or future version