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