mtracker

cli movie tracker written in Rust - keep track of watched movies and series

What's this?

mtracker is a simple cli tool that lets you keep track of watched movies and series.

• 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.

Database

The database is just a plain text file that you may 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

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:

• 1 to 10: Rate the way that most websites do.
• 1 to 5: In case you prefer fewer options. No decimal numbers though.
• 0 to 1: Binary mode, or: Like/Dislike. Simple! Ratings don't have to start at 1.
• 0 to 2: My personal favorite:
  • 2 = Like
  • 1 = Okayish
  • 0 = Dislike

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.

Command examples