Meow: a Mastodon export viewer

Hi! This is a tool that allows you to view your Mastodon export file. Just click “select a file” on the main page, choose your Mastodon archive (with .tar.gz extension) and enjoy!

To export all your toots in Mastodon, go to Preferences > Import and export, click “request your archive” and wait for it to become available for download.

Features:
  • Viewing toots and boosts
  • Scope filtering
  • Toot text search
  • Image and video attachment support
  • Custom emoji support in toots and usernames
  • Viewing starred toots and bookmarks
  • Basic keyboard navigation
  • Showing your tooting statistics!

Frequently Asked Questions

Q: Why does meow show an error instead of some of my starred toots?

A: The file you export from your Mastodon profile doesn't contain your starred toots, it only has links to them. Meow tries to download those toots from the instances they're located on. So if the toot author has deleted it or the instance is down (or some other network error ocurred), meow shows an error.

Q: When was meow last updated?

A: This version was built on February 3 2021, 17:13 UTC

Q: Who drew these amazing cats?

A: @ais05!

Q: Meow crashes when I try to open an archive

A: That shouldn't happen, your archive is probably too large. I haven't seen this happen before, please, report the bug to me (see the next section). (As you might've already guessed, some of these frequently asked questions were never actually asked, and I hope that this question will remain being one of them.)

Q: How do I report bugs?

A: Tag @meowViewer@toot.cafe on Mastodon. Preferably in a public toot, but followers-only and direct messages are ok, too.

Q: Search doesn't find a toot even though I know for sure it has the word I'm searching for!

A: Due to browser storage limitations, search can only find a substring if it's located in the beginning of a word. For example, if you search for “cat”, you'll see toots that have words “cat” and “catgirl” (and even “Cat”), but not “pussycat”.

This limitation also makes search sensitive to word splitting. When indexing your toots, it strips machine codes and splits the resulting text by spaces and some special symbols. But some special symbols (“#”, “.”, “@”) are left out from that set intentionally. So you can find “#hashtag” when searching for “#hash”, but not “hash”.

Current list of characters used to split words: \/"*:;,&!?()^{}[]

Q: Which words are counted in stats?

A: Meow attempts to only count meaningful words, as you wouldn't want to see “a”, “the” and “is” at the top of the list. However, our list of stopwords isn't perfect, so some may slip through the filter.

Only English words are filtered. In other languages, all words are counted.

A: Toot links usually have long numbers at the end. Paste this number into the search box, click “go” and your toot should be there.

Q: Keyboard navigation?

A: You can use Tab to jump from one element to another, enter to activate them, arrow keys to switch pages.

Q: Does meow send my toots anywhere?

A: No, meow doesn't send your toots anywhere, they are processed locally on your computer. However, meow needs to connect to foreign servers to fetch remote emoji, images and starred toots. We also use GoatCounter analytics, it doesn't log any personally identifying information (a hash of your IP address, user agent and a random number is logged together with the page address and some data about your browser).

Meow is not open-source (yet?), so if you're asking yourself whether you can trust meow, you aren't wrong to question it. To verify that your data isn't sent anywhere, you can open your browser's devtools and go to the network tab. It should show all the network requests.

Q: Open-source components used in meow

A: UI framework: Vue.js
IndexedDB wrapper: Dexie.js
Gzip library: Pako
Tar library: js-untar
Date/time display: dayjs
HTML processing: DOMPurify
Filter and search icons: Font Awesome
Charting library: Chart.js

Q: Similar software?

A: Mastodon Archive Tool is a tool for searching toots. It uses a different algorithm, so limitations of meow search don't apply to it.

mastodon-data-viewer.py is an offline tool for viewing and searching toots and attachments. It is written in Python and requires installation.

mastodon-archive-viewer is another offline tool for viewing toots. It supports filters for boosts, toots with media, replies, etc. It is written in OCaml and requires installation.

If you find another piece of software that works with Mastodon export archives, please tell me!