🎬 movie-ost-finder

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

---

🚀 Installation

``bash
npm install -g movie-ost-finder
`

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

`bash
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:

`json
{
"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:

`bash
node src/index.js
`

Or, if you published it globally:

`bash
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

$3


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