Streaming Buddy 📺

Personal streaming assistant that learns your taste, tracks your watching habits, and suggests what to watch next.

Features

• Search & Info: Find movies/TV shows with TMDB data
• Watch Tracking: Track what you're currently watching with progress
• Learning System: Learns your preferences from likes/dislikes/ratings
• Smart Recommendations: Personalized suggestions based on your taste
• Mood-Based Search: Find content by mood (exciting, relaxing, scary, etc.)
• Availability Check: Shows which of your services has the content
• Match Explanation: Explains why a title matches your preferences

Commands

| Command | Action | |---------|--------| | /stream | Show status with all commands | | /stream search <title> | Search for movies/TV shows | | /stream info <id> [tv\|movie] | Detailed info + availability | | /stream watch <id> [tv\|movie] | Start tracking a title | | /stream progress S01E05 | Update progress on current show | | /stream done [1-5] | Mark as finished + rate (auto-learns) | | /stream like [id] | Mark as liked → learns preferences | | /stream dislike [id] | Mark as disliked → learns preferences | | /stream suggest [service] [tv\|movie] | Personalized recommendations | | /stream mood <mood> | Search by mood | | /stream surprise | Random recommendation | | /stream why <id> | Explain why this matches you | | /stream watchlist | Show watchlist | | /stream watchlist add <id> | Add to watchlist | | /stream history | View watch history | | /stream profile | Show your taste profile | | /stream services | Manage streaming services | | /stream services add <name> | Add a service | | /stream services remove <name> | Remove a service |

Mood Options

| Mood | Genres | |------|--------| | exciting | Action, Thriller, Sci-Fi, Adventure | | relaxing | Comedy, Animation, Family, Documentary | | thoughtful | Drama, Mystery, History | | scary | Horror, Thriller | | romantic | Romance, Drama | | funny | Comedy, Animation |

Supported Services

• netflix, amazon-prime, disney-plus, apple-tv-plus
• youtube-premium, wow, paramount-plus, crunchyroll
• joyn, rtl, magenta, mubi

Learning System

The skill learns your preferences from:

1. Ratings: When you finish with /stream done [1-5]:

   • Rating 4-5: Adds genres/themes/actors to "liked"
   • Rating 1-2: Adds genres to "avoided"

2. Explicit Feedback: /stream like and /stream dislike:

   • Extracts genres, themes, actors, directors
   • Updates preference weights

3. Preference Profile includes:

   • Genre preferences (weighted scores)
   • Liked/disliked themes
   • Favorite actors & directors
   • Custom mood mappings

Handler Usage

# Core commands
handler.sh status $WORKSPACE
handler.sh search "severance" $WORKSPACE
handler.sh info 95396 tv $WORKSPACE
handler.sh watch 95396 tv $WORKSPACE
handler.sh progress S01E05 $WORKSPACE
handler.sh done 5 "Great show!" $WORKSPACE

# Learning commands
handler.sh like $WORKSPACE                    # Like current watching
handler.sh like 12345 movie $WORKSPACE        # Like specific title
handler.sh dislike $WORKSPACE
handler.sh why 95396 tv $WORKSPACE
handler.sh profile $WORKSPACE

# Recommendation commands
handler.sh suggest $WORKSPACE                 # All services, all types
handler.sh suggest prime movie $WORKSPACE     # Prime movies only
handler.sh mood exciting $WORKSPACE
handler.sh mood relaxing tv $WORKSPACE
handler.sh surprise $WORKSPACE

# List commands
handler.sh watchlist list $WORKSPACE
handler.sh watchlist add 12345 tv $WORKSPACE
handler.sh history $WORKSPACE

# Service management
handler.sh services list $WORKSPACE
handler.sh services add netflix $WORKSPACE
handler.sh services remove netflix $WORKSPACE

Data Files

All data stored in $WORKSPACE/memory/streaming-buddy/:

| File | Purpose | |------|---------| | config.json | TMDB API key, region, language | | profile.json | User profile metadata | | services.json | Active streaming services | | preferences.json | Learned taste preferences | | watching.json | Currently watching | | watchlist.json | Want to watch list | | history.json | Watched + ratings | | cache/*.json | API response cache (24h) |

Setup

1. Get TMDB API key: https://www.themoviedb.org/settings/api
2. Store in memory/streaming-buddy/config.json:

   {
     "tmdbApiKey": "your_api_key",
     "region": "DE",
     "language": "de-DE"
   }
   

3. Run /stream setup to configure services

Conversation Examples

Mood-based search:

User: I want something exciting tonight
Bot: 🎬 Exciting picks for you:
     1. Reacher S3 (Prime) ⭐8.5
     2. Jack Ryan (Prime) ⭐8.1
     ...

Learning from feedback:

User: /stream done 5
Bot: ✅ Severance marked as done (⭐5)
     📚 Learned: +Drama, +Mystery, +Sci-Fi
     Actors: Adam Scott, Britt Lower saved to favorites

Explaining recommendations:

User: /stream why 95396
Bot: 🎯 Why Severance matches you:
     ✓ Genre "Drama" (you like this, +2)
     ✓ Genre "Mystery" (you like this, +2)
     ✓ Theme "office" in your preferences
     ✓ With Adam Scott (your favorite)
     Similar to: Fallout ⭐5

Language Support

• Language detected from config.json (language: "de-DE" or "en")
• All output adapts to configured language
• Commands work in any language

Requirements

• jq (JSON processor)
• curl (HTTP client)
• bash 4.0+
• TMDB API key (free)

References

• services.md — Full list of streaming services
• tmdb-api.md — TMDB API usage
• justwatch.md — Availability data integration