ephemetoot-eliminare-vecchi.../README.md

70 lines
3.7 KiB
Markdown
Raw Normal View History

2018-12-24 05:30:56 +01:00
A script for deleting old toots.
2019-03-08 06:16:00 +01:00
Based partially on [tweet-deleting script](https://gist.github.com/flesueur/bcb2d9185b64c5191915d860ad19f23f) by [@flesueur](https://github.com/flesueur)
2018-12-24 05:30:56 +01:00
# Usage
You can use this script to delete [Mastodon](https://github.com/tootsuite/mastodon) toots that are older than a certain number of days. By default it will keep any pinned toots, but you can change `save_pinned` to `False` in `config.py` if you want them to be deleted. You can also make a list toots that you want to save, by adding the ID numbers to the `toots_to_save` list in `config.py` (see point 9 below). The ID of a toot is the last part of its individual URL. e.g. for https://ausglam.space/@hugh/101294246770105799 the id is `101294246770105799`
2018-12-24 05:30:56 +01:00
This script requires Python3, the `mastodon.py` package and an API access token.
2019-03-08 06:16:00 +01:00
# Setup
2019-05-10 02:09:41 +02:00
1. Install Python3 if you don't already have it (recommended approach is to [use Homebrew](https://docs.brew.sh/Homebrew-and-Python) if you're on MacOS)
2018-12-24 05:30:56 +01:00
2. Install the mastodon package: `pip3 install mastodon.py`
2019-03-08 06:16:00 +01:00
3. Copy _example.config.py_ to a new file called _config.py_ (e.g. `cp example.config.py config.py`)
4. Log in to your Mastodon account using a web browser
2018-12-24 05:35:55 +01:00
1. Click the settings cog
2. Click on Development
3. Click 'NEW APPLICATION'
4. Enter an application name, and give the app 'read' and 'write' Scopes
5. Click 'SUBMIT'
6. Click on the name of the new app
7. Copy the 'access token' string
2018-12-24 05:30:56 +01:00
5. Replace `YOUR_ACCESS_TOKEN_HERE` in config.py with the access token string
6. Set the base_url to match your mastodon server
7. Set the `days_to_keep` to the number of days you want to keep toots before deleting them
2018-12-24 05:40:58 +01:00
8. If you do **not** wish to keep all pinned toots regardless of age, change `save_pinned` to `False`
2018-12-24 05:30:56 +01:00
9. If there are any other toots you want to keep, put the ID numbers (without quotes) in the `toots_to_save` list, separated by commas. For example:
2018-12-24 05:35:55 +01:00
2019-03-08 06:16:00 +01:00
`toots_to_save = [100029521330725397, 100013562864734780, 100044187305250752]`
# Running the script
## Test mode
To do a test-run without actually deleting anything, run the script with the '--test' flag: `python3 ephemetoot.py --test`
2019-05-10 02:09:41 +02:00
Depending on how many toots you have and how long you want to keep them, it may take a minute or two before you see any results.
2019-03-08 06:16:00 +01:00
## Live mode
Run the script with no flags: `python3 ephemetoot.py`.
Depending on how many toots you have and how long you want to keep them, it may take a minute or two before you see any results.
2018-12-24 05:35:55 +01:00
2019-05-10 02:09:41 +02:00
## Scheduling
Deleting old toots daily is the best approach to keeping your timeline clean and avoiding problems wiht the API rate limit.
2019-03-08 06:16:00 +01:00
To run automatically every day you could try using crontab:
1. `crontab -e`
2. `@daily python3 ~/ephemetoot/ephemetoot.py`
2018-12-24 05:30:56 +01:00
2019-05-10 02:09:41 +02:00
Alternatively on MacOS you could use [launchd](https://www.launchd.info/). An install script to set up automation with launchd is [on the list](https://github.com/hughrun/ephemetoot/issues/5) of things to be done.
## Rate limits
As of v2.7.2 the Mastodon API has a rate limit of 30 deletions per 30 minutes. `mastodon.py` automatically handles this. If you are running `ephemetoot` for the first time and/or have a lot of toots to delete, it may take a while as the script will pause when it hits a rate limit, until the required time has expired.
2019-03-08 06:16:00 +01:00
# Bugs and suggestions
2018-12-24 05:30:56 +01:00
2019-05-10 02:09:41 +02:00
Please check existing [issues](https://github.com/hughrun/ephemetoot/issues) and if your issue is not already listed, create a new one with as much detail as possible (but don't include your access token!).
# Contributing
Contributions are very welcome, but if you want to suggest any changes or improvements, please log an issue or have a chat to [me on Mastodon](https://ausglam.space/@hugh) _before_ lodging a pull request.
2018-12-24 05:30:56 +01:00
# License
2019-03-08 06:16:00 +01:00
GPL 3.0+