1.5 KiB
DOWNload FAVourites
downfav is a simple application to download your Mastodon favourites, either
in Org or Markdown formats.
Running
At first, running downfav should display nothing. The reason is that there
are no accounts or storage options for those accounts.
To create an account you need to run downfav <accountalias> create. This will
start the registration process for that account.
Next, you need to define where you want your favourites to be saved. To do
this, use downfav <accountalias> storage add <storagetype>. Currently, there
are two storage types: markdown and org.
The Markdown Storage
The Markdown storage uses a directory structure based on the account name and
toot id. This means that, if you favourited a toot by "someuser@server"
identified by "123123", a tree like <base storage directory>/someuser@server/123123 will be created and the content will be
saved there.
(This storage is usually recommended if you normally favourite content with lots of attachments, as each toot attachment -- image/video -- will be stored alongside the toot text.)
The Org Storage
The Org storage is similar to the Markdown storage, but instead of creating a
new file for each toot, every favourite will be added to a <base storage directory>/<date>.org file; any attachments will be stored (and properly
linked) in <base storage directory>/date/ directory.
(This storage is usually recommended if you normally favourite content with lots of text and not much of attachments.)
License
GNU AFFERO GENERAL PUBLIC LICENSE, Version 3.