TMDB CLI

Ein plattformübergreifendes Command-Line Tool zum Abrufen von Film-, Serien- und Personeninformationen von The Movie Database (TMDB).

Features

• 🎬 Suche nach Filmen mit detaillierten Informationen
• 📺 Suche nach Serien mit Staffelübersicht
• 👤 Suche nach Personen (Schauspieler, Regisseure) mit Filmografie
• 🎨 Ansprechende, farbige Terminal-Ausgabe
• 📋 Interaktive Auswahlliste bei mehreren Ergebnissen
• 📄 JSON-Ausgabe für Skript-Integration
• 🌍 Mehrsprachige Unterstützung (5 Sprachen)

Installation

Voraussetzungen

• Go 1.22 oder höher
• TMDB API Key (kostenlos erhältlich)

Via Go

go install github.com/mmeister86/tmbd_cli/cmd/tmdb@latest

Wichtig: Stelle sicher, dass $GOPATH/bin (meistens ~/go/bin) in deinem PATH ist:

export PATH="$HOME/go/bin:$PATH"

Manuell bauen

git clone https://github.com/mmeister86/tmbd_cli.git
cd tmbd_cli
make build
make install

Binaries herunterladen

Vorkompilierte Binaries für verschiedene Plattformen findest du unter Releases.

API Key einrichten

1. Erstelle einen Account auf TMDB
2. Gehe zu API Settings
3. Erstelle einen API Key (v3 auth)
4. Setze die Umgebungsvariable:

Bash/Zsh:

export TMDB_API_KEY='dein-api-key'

# Permanent (in ~/.bashrc oder ~/.zshrc)
echo "export TMDB_API_KEY='dein-api-key'" >> ~/.zshrc

Fish:

set -Ux TMDB_API_KEY 'dein-api-key'

Windows (PowerShell):

$env:TMDB_API_KEY = 'dein-api-key'

# Permanent
[Environment]::SetEnvironmentVariable("TMDB_API_KEY", "dein-api-key", "User")

Verwendung

Filme suchen

tmdb movie "The Matrix"
tmdb m "Inception"
tmdb film "Pulp Fiction"

Serien suchen

tmdb series "Breaking Bad"
tmdb s "Dark"
tmdb tv "The Office"
tmdb show "Stranger Things"

Personen suchen

tmdb person "Tom Hanks"
tmdb p "Meryl Streep"
tmdb actor "Leonardo DiCaprio"

Optionen

Flag	Kurzform	Beschreibung
--help	-h	Hilfe anzeigen
--version	-v	Version anzeigen
--json		Ausgabe als JSON
--short	-s	Kompakte Ausgabe
--language	-l	Sprache überschreiben (z.B. en-US)

Sprache konfigurieren

Die Standard-Sprache ist Deutsch (de-DE). Du kannst die Sprache dauerhaft ändern:

# Interaktive Sprachauswahl
tmdb language

Unterstützte Sprachen:

• Deutsch (de-DE)
• Englisch (en-US)
• Französisch (fr-FR)
• Spanisch (es-ES)
• Italienisch (it-IT)

Alternativ kannst du die Sprache für einzelne Anfragen überschreiben:

# Englische Ergebnisse
tmdb movie "The Matrix" --language en-US

# Französische Ergebnisse
tmdb series "Les Misérables" --language fr-FR

Die Sprachauswahl wird in ~/.tmdb/config.json gespeichert.

Beispiele

# Detaillierte Filminfos
tmdb movie "The Matrix"

# Kompakte Ausgabe
tmdb movie "Inception" --short

# JSON-Ausgabe (z.B. für jq)
tmdb movie "Fight Club" --json | jq '.rating'

# Personensuche mit JSON
tmdb person "Brad Pitt" --json | jq '.known_for_works[0].title'

# Kompakte Personeninfos
tmdb p "Meryl Streep" --short

# Englische Ergebnisse
tmdb series "Game of Thrones" --language en-US

Konfiguration

Die Konfiguration wird in ~/.tmdb/config.json gespeichert.

Umgebungsvariable	Beschreibung	Standard
TMDB_API_KEY	TMDB API Key (v3 auth)	Pflicht
TMDB_LANGUAGE	Sprache für Ergebnisse (wenn keine Config vorhanden)	de-DE

Sprachpriorität:

1. --language Flag (einzelne Anfrage)
2. Config-Datei (~/.tmdb/config.json)
3. Umgebungsvariable (TMDB_LANGUAGE)
4. Standard (de-DE)

Entwicklung

# Dependencies installieren
go mod tidy

# Bauen
make build

# Tests ausführen
make test

# Formatieren und Linting
make lint

# Cross-Compilation für alle Plattformen
make build-all

Technologie-Stack

• Go - Programmiersprache
• Cobra - CLI Framework
• Bubble Tea - Terminal UI Framework
• Lipgloss - Terminal Styling
• TMDB API - Datenquelle

Lizenz

MIT License - siehe LICENSE für Details.

Danksagungen

• The Movie Database für die kostenlose API
• Charmbracelet für die fantastischen Terminal-Libraries