Back to projects
Jan 01, 2026
6 min read

๐ŸŽฌ MVW

MoVie revieW inspired by fastfetch

NOTES: You can also see my project on PyPI - mvw

๐Ÿ—บ๏ธ Table Map

   __  ______  __      ___     __
  /  |/  /| | / /      | | /| / /
 / /|_/ / | |/ /       | |/ |/ / 
/_/  /_/o |___/ie revie|__/|__/ 

Fastfetch inspired movie reviews

Catalogue your own movie review inside your terminal.

pipx install mvw

  โ–โ–     โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
 โ–โ–โ–โ”‚    โ”‚ These are some demos when using MVW โ”‚
โ”Œโ”˜โ”” โ–‘โ–Œ   โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ
โ•šโ•โ•โ•โ•    F: Psst.. his name is MOAI (nice to meet u)                                     

Interactive

Default usage where you will get to experience the full experience of MVW. You will get to search, rate, review and also save your review. Every reviews will be saved in your local machine!

Interactive Command

List

You will get to see every past reviews that you had done in a simple interface supported by iterfzf) which uses the โ€œFuzzy Searchโ€

List Command

Config

Everything that you can see in the config list can be configurable. From the poster_width, theme, your name, and even worldwide-boxoffice feature

Config Command

Theme

NOTE: Some browser not fully support nerdfont rendering of svg, you can see below if it is supported.

  • Gruvbox (The Default Theme) Gruvbox

  • Catppuccin Catpuccin

  • Nord Nord


Features

FeaturesNotes
Auto fetch movie dataUses OMDb API behind the hood to fetch movie data fast
Search movieUsing iterfzf to list down all close-to-name movies
Pixelated posterUnique way to view the poster (fully intentional)
Configurable poster sizeCan change the poster width
Review historyAll review are saved in a database
AutocompleteProvided by the Typer library
ThemesGruvbox, Catppuccin, Nord
Save ReviewThe review can be saved in svg format with the theme
Worldwide BoxofficeUse webscrap tech to find the global box office
Half-star RatingSupport 0.5 star rating
Review EditorUse default editor to edit review
Caching PosterNo need to download the poster everytime fetching
Easy updateWhen searching same movie, will use past review
Reset ConfigDefault to the factory setting with single command
Moai helpFun gimmick to help you in the process (can be hide dont worry)
  โ–โ–     โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
 โ–โ–โ–โ”‚    โ”‚ Why am I at the bottom? โ”‚
โ”Œโ”˜โ”” โ–‘โ–Œ   โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ
โ•šโ•โ•โ•โ•    F: Cause heroes appear last.. right..                                  

Motivation

I have a deep interest in TUI/CLI and also movie in general. I also have a vault in Obsidian where I catalogue movies that I watch but you know how it goes.. (Legend says that it was still there waiting for me :D) At first, as someone like me whose personality (TUI + Movie) will obviously create a movie player that does everything (find, torrent, play, and done) which has already been done so many times. So instead I just want to make something different and thatโ€™s where I (finally) remember about my Obsidian movie catalogue. Then the code begins..

And also, I just want to learn new things :)


Installation

MethodCommand
pipx (recommended)pipx install mvw
uvuv tool install mvw
pippip install mvw

NOTE: This CLI require a nerdfont to have the icon fully showed โ€”> This repo seems legit way to install nerdfont but its up to you how to install, google it, you got this!

Usage

mvw

CLI

# Configure
mvw config -h

# All configure settings
mvw config --api-key "OMDB API key"       # Required
mvw config --name "Name"                  # Optional
mvw config --poster-width 30
mvw config --theme "gruvbox"
mvw config --moai                         # Toggle
mvw config --review                       # Toggle
mvw config --worldwide-boxoffice          # Toggle
mvw config --reset                        # Toggle

# List all reviewed movies
mvw list

# Preview the reviewed movies
mvw preview --id "ttxxxxxx"
mvd preview --title "Inception"

# Delete the reviewed movies
mvw delete --id "ttxxxxxx"
mvd delete --title "Inception"

Configuration

Settings are atuomatically configured using mvw config

FAQ

  โ–โ–     โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
 โ–โ–โ–โ”‚    โ”‚ Why am I here?  โ”‚
โ”Œโ”˜โ”” โ–‘โ–Œ   โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ
โ•šโ•โ•โ•โ•     F: Just for fun i guess

Why does the poster pixelated?

During the early build of the project, I could not figure out a way to pipe a kitty image into the iterfzf preview section. It took a long time to process so I try another method which is using rich_pixel library which supports rich and also works on every OS. As of now, thats what I could think of to solve it. TLDR: you can think it as the intended style

Why do I need to register an API key?

Short answer: Itโ€™s easier for me to implement and itโ€™s very fast!

Long answer: During the early build, I tried to use an API from TMDb, however I found that the registering process are quite intimidating. Then, I found OMDb (which is almost the same as TMDb but easier API key registration). Later down the road, I also tried a no-API-key path Cinemagoer. However, I couldnโ€™t (as of now) make it work yet. Naybe in the future, another non-API option will arise?!

Who is MOAI?

It is just a console.print that I decided to add a face. I choose Moai because, the emoji ๐Ÿ—ฟ is just too perfect and one of my friends has used it during the phonk era (a lot). The emoji name is also MOAI so I thought why not just MO(AI) it. Same to LLM in Ollama, just too good to not use.


Inspiration

mvw is built with Typer and inspired by:

  • fastfetch - Visual system information Display.

License

GPL-3.0