a989abc80b | ||
---|---|---|
.github | ||
docs | ||
ephemetoot | ||
tests | ||
.gitignore | ||
CODE_OF_CONDUCT.md | ||
LICENSE | ||
README.md | ||
example-config.yaml | ||
poetry.lock | ||
pyproject.toml |
README.md
🥳 ==> 🧼 ==> 😇
ephemetoot is a Python command line tool for deleting old toots.
Quickstart
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
Documentation
You can also read the docs at ephemetoot.hugh.run
Prior and related work
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.
Usage
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
Contributing
ephemetoot is packaged using poetry
and tested using pytest
.
For all bugs, suggestions, pull requests or other contributions, please check the contributing guide.
License
This project and all contributions are licensed under the GPL 3.0 or future version