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

Mood Options

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/:

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