imdb-id 1.0.3

Get IMDb IDs using a commandline search tool
Documentation

IMDb ID

Crates.io GPL v3

An easy-to-use commandline tool to easily look up the IMDb ID of a movie given its name

It's built for both easy interactive use and scripting capabilities

Why does this exist?

Because certain sites support searching using these IMDb IDs and it's really useful as an unambiguous identifier

How do I install it?

You need to have Rust installed on your system, then run the following:

cargo install imdb-id

Usage

USAGE:
    imdb-id [FLAGS] [OPTIONS] [--] [search_term]...

ARGS:
    <search_term>...
            The title of the movie/show you're looking for

FLAGS:
    -h, --help
            Prints help information

    -n, --non-interactive
            Disables interactive features (always picks the first result)

    -V, --version
            Prints version information


OPTIONS:
    -g, --genre <filter_genre>...
            Filters results to a specific genre
            Can be given multiple arguments or passed multiple times, working as a chain of OR
            statements logically. Filters are all case insensitive
            It is STRONGLY recommended you quote genres with double quotes, as most have spaces
            Examples include: Movie, "TV episode", "TV series"

    -y, --year <filter_year>
            Filters results to a specific year, or range of years
            Examples: 2021, 1990-2000, 2000- (2000 onwards), -2000 (before 2000)

    -r, --results <number_of_results>
            The maximum number of results to show from IMDb

Roadmap

  1. Proof of concept - done as of v0.1.0!
  2. CLI option parsing and non-interactive 'feeling lucky' mode with appropriate output - done as of v0.2.0!
  3. Interactive mode - done as v1.0.0!
  4. Result pagination - done as of v1.0.1!
  5. Filtering by genre - done as of v1.0.2! (note: the v1.0.2 release has glaring bugs, please don't use it)
  6. Filtering by year - done as of v1.0.3!
  7. Customising fields shown in search results
  8. Use async/tokio properly
  9. Different output format support: JSON, YAML, etc.
  10. ???
  11. Profit