package mastodon-archive-viewer

How to install mastodon-archive-viewer

First you need an initialized OPAM installed If you don't have it installed, it can be fetched from your system packages manager. Then to initialize it, do opam init -a, then eval $(opam config env)

Now, to install mastodon-archive-viewer, do opam pin add mastodon-archive-viewer .

How to use mastodon-archive-viewer

Now that mastodon-archive-viewer is installed you just need to download the archive you want to view, extract it in a new directory, then do:

$ cd <the archive directory>
$ mastodon-archive-viewer outbox.json

The mastodon-archive-viewer tool has also some options to filter out some items for example. Check out the available options with mastodon-archive-viewer --help

Hidden feature

mastodon-archive-viewer can detect gifs vs. videos and thus display them differently. However this feature for now requires the devel version of the ffmpeg OCaml bindings. If you want this feature you'll have to install the dev version manually using:

$ opam pin add ffmpeg git://github.com/kit-ty-kate/ocaml-ffmpeg.git

Troubleshootings

If the installation fails somewhere while building the dependencies, you might miss one of these tools on your systems: make, gcc, m4, libc-dev. This might happen on a newly installed Alpine Linux, for instance.

TODO

• Testing (I guess I missed some heuristics, help welcome!!)
• Documentation
• Clean code and better errors