Month: December 2024

Again a quick not for myself and putting a copy here in case something internets goes poof; https://docs.joinmastodon.org/admin/tootctl/#media

tootctl media remove

Removes locally cached copies of media attachments, avatars or profile headers from other servers. By default, only media attachments are removed.

--days N

How old media attachments have to be before they are removed. In case of avatars and headers, how old the last webfinger request and update to the user has to be before they are removed. Defaults to 7.

--concurrency N

The number of workers to use for this task. Defaults to N=5.

--prune-profiles

Instead of media attachments, remove locally cached copies of avatars and headers from other servers. Cannot be combined with --remove-headers.

--remove-headers

Instead of media attachments, remove locally cached copies of headers from other servers. Cannot be combined with --prune-profiles.

--include-follows

Override the default behavior of --prune-profiles and --remove-headers to remove locally cached copies of avatars (and headers) from other servers, irrespective of follow status (by default, they are only removed from accounts that are not followed by or following anyone locally). Can only be used with --prune-profiles or --remove-headers.

--verbose

Print additional information while task is processing.

--dry-run

Print expected results only, without performing any actions.

---

tootctl media remove-orphans

Scans for files that do not belong to existing media attachments, and remove them. Please mind that some storage providers charge for the necessary API requests to list objects. Also, this operation requires iterating over every single file individually, so it will be slow.

--start-after

The Paperclip attachment key where the loop will start. Use this option if the command was interrupted before.

--dry-run

Print expected results only, without performing any actions.

--prefix

Traverse only a specific prefix of files in the system.

--fix-permissions

Sets S3 ACL to be default according to environment variables.

---

tootctl media refresh

Refetch remote media attachments from other servers. You must specify the source of media attachments with either --status, --account, --domain, or --days. If an attachment already exists in the database, it will not be overwritten unless you use --force.

--account ACCT

String username@domain handle of the account

--domain DOMAIN

FQDN string

--status ID

Local numeric ID of the status in the database.

--days N

The number of days to limit this task to.

--concurrency N

The number of workers to use for this task. Defaults to 5.

--verbose

Print additional information while task is processing.

--dry-run

Print expected results only, without performing any actions.

--force

Force redownload the remote resource and overwrite the local attachment.

---

tootctl media usage

Calculate disk space consumed by Mastodon.

---

tootctl media lookup

Prompts for a media URL, then looks up the status where the media is displayed.

---