mtracker

mtracker is a simple cli tool for Linux that lets you keep track of watched movies and series. Or any other kind of media, like books and video games.

• Designed to work well with standard Linux command line tools like grep.
• Flat file system: All data is saved in a human-readable text file.
• No built-in cloud synchronization. Of course, you can set up some kind of synchronization yourself if you wish to.
• No data is fetched from the internet. You enter all the information that's useful to you manually.

Installation

If you have Rust installed, you can simply use cargo:

cargo install mtracker

Otherwise just download the latest release and put it somewhere within your PATH variable, e.g.: /usr/local/bin

sudo curl -o /usr/local/bin/mtracker https://github.com/r-unruh/mtracker/releases/latest/download/mtracker

Don't forget to make the file executable:

sudo chmod +x /usr/local/bin/mtracker

More user-friendly install options will probably be added at some point.

Tutorial

Let's assume your friend Max tells you about a fun horror movie. This is how you add it to your watchlist:

mtracker add "Pearl (2022)" --tag=watchlist --note="Recommended by Max"

After watching the movie you decide to rate it a 8/10:

mtracker rate "Pearl (2022)" 8

This command assumes that you have now watched the item and removes it from the watchlist automatically.

You can rate movies you already know directly without having to add them first:

mtracker rate "Session 9 (2001)" 10
mtracker rate "In Fabric (2018)" 4

Now lets see what we have so far by listing all items:

mtracker ls

Which returns this list, sorted by rating:

++++++++++ Session 9 (2001)
++++++++-- Pearl (2022)
+++------- In Fabric (2018)

This should cover the basics. Type mtracker help [subcommand] to see all options.

[!NOTE] Commands are not yet stable and may change in future versions. Make sure to backup your database on a regular basis.

Database

The database is just a plain text file that you can edit by hand. It looks like this:

Forrest Gump
year: 1994
rating: 9
tags: drama, comedy
last_seen: 2020-12-31

Bodies Bodies Bodies
year: 2022
tags: watchlist
note: recommended by Max

Whiplash
rating: 10

On Linux, the database file is automatically created and stored in ~/.local/share/mtracker/db.txt. If any relevant XDG environment variables (e.g., XDG_DATA_HOME) are set, they will be respected, and the file will be stored according to the XDG Base Directory Specification.

Features

Ratings

You can rate movies on a scale of your choice. mtracker doesn't force a rating system. The highest rated item in your database determines the scale: If the highest rated movie is a 7, then all the ratings go from 0 to 7. Of course, you don't have to rate anything at all.

Here are a few options:

Tags

You can tag movies and filter by tags when listing them later. watchlist is a special tag that highlights items and puts them on top of everything else.

Special search terms

When listing items with the ls subcommand, you can filter for additional attributes:

Command examples