🎬 movie-ost-finder

Find the soundtrack authors and tracklist of your favorite movies directly from a local JSON database.

🚀 Installation

npm install -g movie-ost-finder

or, if you want to use it without installing globally:

npx movie-ost-finder

🧠 How it works

This tool asks for a movie name, looks it up inside a local movies.json file, and prints out the soundtrack authors and tracklist.

It uses:

• readline for CLI input
• fs/promises for reading the JSON file
• speakingurl for slug normalization (to match titles even if the user types extra spaces or different capitalization)

🧩 Example JSON file

Your movies.json should look like this:

{
  "films": [
    {
      "film_name": "Akira",
      "soundtrack_authors": ["Geinoh Yamashirogumi"],
      "tracks": [
        "Kaneda",
        "Battle Against Clown",
        "Tetsuo",
        "Shohmyoh",
        "Exodus from the Underground Fortress"
      ]
    },
    {
      "film_name": "Profondo Rosso",
      "soundtrack_authors": ["Goblin", "Giorgio Gaslini"],
      "tracks": [
        "Profondo Rosso (Main Theme)",
        "Mad Puppet",
        "Death Dies",
        "Deep Shadows"
      ]
    }
  ]
}

💻 Usage

Run the script:

node src/index.js

Or, if you published it globally:

movie-ost-finder

Then type the movie name when prompted:

Tell me the name of a movie: Akira
🎼 Authors: Geinoh Yamashirogumi
🎵 Tracklist:
1. Kaneda
2. Battle Against Clown
3. Tetsuo
4. Shohmyoh
5. Exodus from the Underground Fortress

⚙️ Project structure

movie-ost-finder/
├── src/
│   └── index.js
├── movies.json
├── package.json
└── README.md

📦 Exports

findOst()

Main async function that:

1. Prompts the user for a movie name
2. Normalizes the title using getSlug
3. Reads the local JSON file
4. Finds the corresponding movie
5. Prints the soundtrack authors and tracklist to the console

🧰 Dependencies

| Package | Description | |----------|-------------| | speakingurl | Converts movie titles into comparable slugs | | fs/promises | Reads JSON file asynchronously | | readline | Handles CLI input/output |

🪪 License

MIT © 2025 Madda