TMDB Search is a macOS application that enables users to search and browse The Movie Database (TMDB) for movies, TV shows, and collections. The app is designed to help users discover detailed metadata and high-quality artwork, saving them for use in media libraries such as Plex or Kometa, and assisting with media organization workflows like Filebot renaming and import.
- 🔍 Search TMDB: Quickly search for movies, TV shows, or collections using TMDB's rich database.
- 📝 Detailed Metadata: View comprehensive details for each media item, including titles, overviews, release dates, genres, cast, and TMDB-compliant folder names.
- 🎨 Artwork Browsing: Browse a grid of posters and backdrops for any show, movie, or collection, preview with high-resolution images.
- 💾 Artwork Download: Save selected posters and backdrops to your asset metadata folder, ready for import into media managers such as Plex or Kometa.
- 🗂️ TMDB Folder Name & ID: Retrieve TMDB-compliant folder names and TMDB-IDs for each media item. Use these identifiers in workflows such as Filebot renaming.
- 📤 Export for Media Libraries: Prepare and organize artwork and metadata for seamless integration with Plex, Kometa, or other media asset tools.
- 🕑 Search History: Easily revisit previous searches and manage your search history.
- 🟦 Customizable Grid: Adjust the grid layout for artwork browsing to fit your preferences.
- Locating and saving official TMDB artwork for your personal media collection.
- Organizing your Plex or Kometa asset folders with matching folder names and images.
- Exporting TMDB-IDs for use in batch renaming or automation tools like Filebot.
- Researching metadata details for movies, shows, or collections.
Keyboard shortcuts for search categories, or use the Search buttons.
| Shortcut | Keyboard | Feature |
|---|---|---|
| ↵ | Return | Search for Shows |
| ⇧↵ | Shift+Return | Search for Movies |
| ⌥↵ | Option+Return | Search for Collections |
| ⌘⇧H | Command+Shift+H | Show Search History |
| ⌘⌫ | Command+Backspace | Clear Search |
Keyboard shortcuts for each search result row-item, or use the control button.
| Shortcut | Keyboard | Feature |
|---|---|---|
| Tap | Left-Click | Copy the media name, followed by the year (ie, "The Matrix (1999)")) |
| ⌘+Tap | Command+Left-Click | Copy the media name only without the year (ie, "The Matrix") |
| ⌥+Tap | Option+Left-Click | Copy the media TMDB-ID (ie, 603) |
| ⌃+Tap | Control+Left-Click | Copy the update-poster script command (ie, upp "The Matrix (1999)" -l movies") |
| Shortcut | Keyboard | Feature |
|---|---|---|
| Tap | Left-Click | Save the image to the file-system |
| ⌥+Tap | Option+Left-Click | Flip the image horizontally first, before saving to the file-system |
| Movies | TV Shows |
|---|---|
 |
 |
| Posters | Backdrops |
|---|---|
 |
 |
| Platform | Minimum Swift Version | Xcode | Required Packages |
|---|---|---|---|
| macOS 10.12+ | 6.0 | 16.0 | SwiftLint Plugins 0.59.1+, SFSymbol 3.0.0+ |
- Clone this repository to your local machine:
git clone TMDB_Search