janet-mastodon-bookmarks/README.md
2024-06-24 09:09:39 +02:00

1.3 KiB

Mastodon Bookmarks Archive

Release download

A small Janet script to archive all your Mastodon bookmarks in Markdown files.

Because Mastodon posts can disappear for a variety of reasons (deletion, defederation, server instance shutdown, ...), it is safer to archive your bookmarks.

Each Markdown file will contain:

  • A link to the original post
  • The author's handle
  • The post's content in HTML
  • The media attachments locally downloaded
  • If available, the alt text for each media

Most of these values will be in the form of key:: value for easy integration with Obsidian's plugin Dataview. A sample script is available here

Setup & Run

  • Get an access token for your Mastodon account


  • Run the program
$ ./mastodon-bookmarks YOUR_INSTANCE YOUR_APP_TOKEN

The YOUR_INSTANCE value must not have the trailing slash (e.g: https://hachyderm.io)

Development

$ janet main.janet YOUR_INSTANCE YOUR_APP_TOKEN

Build binary

$ jpm build

LICENSE

Licensed under GPL-3.