Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hughrun/ephemetoot
A command line tool to delete your old toots: 🥳 ==> 🧼 ==> 😇
https://github.com/hughrun/ephemetoot
mastodon mastodon-api
Last synced: about 2 months ago
JSON representation
A command line tool to delete your old toots: 🥳 ==> 🧼 ==> 😇
- Host: GitHub
- URL: https://github.com/hughrun/ephemetoot
- Owner: hughrun
- License: gpl-3.0
- Created: 2018-12-24T04:22:12.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-08T05:15:21.000Z (over 1 year ago)
- Last Synced: 2024-04-13T13:57:56.450Z (9 months ago)
- Topics: mastodon, mastodon-api
- Language: Python
- Homepage: https://ephemetoot.hugh.run
- Size: 237 KB
- Stars: 50
- Watchers: 3
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 🥳 ==> 🧼 ==> 😇
**ephemetoot** is a Python command line tool for deleting old toots.
**As Mastodon now has similar functionality built in, `ephemetoot` is now in maintenance mode - no new features will be added, only security updates.**
## Quickstart
You should have Python3 and pip installed, and an app access token on hand. More detail information is available in [the docs](https://ephemetoot.hugh.run)
Install with pip:
```shell
pip install ephemetoot
```
Create a config file:
```shell
ephemetoot --init
```
Do a first run in `--test` mode:
```shell
ephemetoot --test
```
Find out about other options:
```shell
ephemetoot --help
```
## Documentation
* [Installation](./docs/install.md)
* [Options](./docs/options.md)
* [Upgrading and uninstalling](./docs/upgrade.md)
You can also read the docs at [ephemetoot.hugh.run](https://ephemetoot.hugh.run)
## Prior and related work
The initial `ephemetoot` script was based on [this tweet-deleting script](https://gist.github.com/flesueur/bcb2d9185b64c5191915d860ad19f23f) by [@flesueur](https://github.com/flesueur)
`ephemetoot` relies heavily on the Mastodon.py package by [@halcy](https://github.com/halcy)
Looks like [Gabriel Augendre had the same idea](https://git.augendre.info/gaugendre/cleantoots). You might prefer to use Gabriel's `cleantoots` instead.
## Usage
You can use `ephemetoot` to delete [Mastodon](https://github.com/tootsuite/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 tested using `pytest`.
For bugs or other contributions, please check the [contributing guide](./docs/contributing.md).
## License
This project and all contributions are [licensed](./LICENSE) under the GPL 3.0 or future version