Key Features

• Track Shows: Add shows to your watchlist and mark episodes as watched
• Manage Services: Track which streaming services you subscribe to
• Provider Bundles: Find streaming bundles from your cable/internet/mobile providers
• Calendar View: Interactive calendar showing upcoming episodes
• Upcoming Episodes: Track upcoming premieres and releases
• Value Analysis: See which services give you the best value
• Smart Recommendations: Get suggestions for new subscriptions and bundles
• Cost Tracking: Monitor your monthly streaming costs
• Data Portability: Export and import your data anytime

Quick Start

1. Set up your streaming services in the Services section
2. Add your cable/internet/mobile providers in the Providers section
3. Use Search Shows to find and add shows to your watchlist
4. Mark shows and episodes as watched on the Dashboard
5. Get Bundle Recommendations to save money on streaming
6. Export your data periodically for backup

Show Management

• Watchlist View: See all your shows at a glance
• Sorting Options: Sort by title, date added, air date, status, or streaming service
• Quick Actions: Mark shows as watched/unwatched with one click
• Show Details: Click any show to see full details, episodes, and seasons

Upcoming Episodes

• List View: Traditional list of upcoming episodes
• Calendar View: Interactive calendar with clickable dates
• Episode Details: Click dates to see episode information
• Visual Indicators: Dates with episodes are highlighted

Statistics

• Subscription Costs: Total monthly streaming costs
• Show Counts: Watched vs unwatched shows
• Service Analysis: Value per service breakdown

Sorting Options

How to Search

1. Enter the show title in the search box
2. Browse the search results
3. Click "Add to Watchlist" for shows you want to track
4. The app automatically fetches show details and streaming services

Search Tips

• Use the full show title for best results
• Try variations if you don't find what you're looking for
• Check the year if there are multiple shows with similar names
• International shows may require exact spelling

What You Get

• Show Information: Title, overview, poster, air dates
• Season Data: Number of seasons and episodes
• Streaming Services: Where you can watch the show
• Status: Ongoing, ended, or returning
• Episode Tracking: Mark individual episodes as watched

Service Actions

• Toggle Subscription: Mark services as subscribed/unsubscribed
• Set as Free: Mark free services (YouTube, Pluto TV, etc.)
• Update Prices: Keep subscription costs current
• Delete Services: Remove services you no longer track
• Add New Services: Search and add missing services

Value Analysis

• Shows per Service: Count of unwatched shows
• Cost per Show: Value calculation
• Subscription Status: Active vs inactive
• Monthly Total: Total subscription costs

Adding Services

1. Click "Search Services" button
2. Search for the service name
3. Click "Add" next to the service you want
4. Or use "Add Service" for custom services

Price Updates

Use the "Refresh Prices" button to update service prices to current market rates. This helps keep your cost analysis accurate.

Provider Management

• Add Providers: Add your cable, internet, or mobile providers
• Bundle Discovery: Find streaming services included with your plans
• Cost Savings: See potential savings with provider bundles
• Automatic Marking: Services are automatically marked as free when included

How Provider Bundles Work

1. Add your current providers (Xfinity, Verizon, T-Mobile, etc.)
2. View available streaming bundles for each provider
3. Select providers you actually have
4. Get personalized bundle recommendations

Bundle Types

• Included: Streaming services completely free with your plan
• Discounted: Services available at reduced prices
• Add-on: Optional services you can add to your plan

Recommendation Engine

• Watchlist Analysis: Based on shows you want to watch
• Provider Comparison: Compare bundles across your providers
• Savings Calculation: See how much you can save monthly
• Service Coverage: Find bundles covering most of your needed services

Package Features

• Multiple Tiers: Netflix Basic, Standard, Premium
• Different Pricing: Each tier has its own cost
• Feature Lists: Video quality, device limits, ads
• Active Selection: Choose which tier you actually have

How to Use

1. Click "Packages" next to a service
2. Review available tiers
3. Select the tier you actually subscribe to
4. Your cost analysis will update automatically

Common Service Packages

Show Details

• Full Information: Overview, cast, air dates
• Season Breakdown: View all seasons and episodes
• Streaming Services: Where to watch
• Watch Status: Track viewing progress
• Metadata Refresh: Update show information

Streaming Service Assignment

• Shows are automatically assigned streaming services
• You can manually edit these assignments
• Multiple services can be assigned to one show
• This affects value calculations

Actions Available

Episode Tracking

• Individual Episodes: Mark each episode as watched
• Season Progress: See completion percentage
• Air Dates: Know when episodes originally aired
• Episode Details: Titles and descriptions
• Bulk Actions: Mark entire seasons as watched

Season Management

• Each season shows episode count and progress
• Mark entire seasons as watched/unwatched
• Filter episodes by season
• See air dates and status

Progress Tracking

Your viewing progress is tracked at multiple levels:

• Episode Level: Individual episodes marked as watched
• Season Level: Entire seasons can be marked watched
• Show Level: Marking a show watched marks all episodes

Upcoming Episodes

The dashboard shows upcoming episodes for your unwatched shows, helping you stay current with ongoing series.

Calendar Features

• Interactive Calendar: Month view with navigation controls
• Episode Indicators: Dates with episodes are highlighted in green
• Clickable Dates: Click any highlighted date to see episodes
• Episode Details: Full episode information in popup modal
• Month Navigation: Previous/next month buttons
• Current Date: Today's date is specially highlighted

Using the Calendar

1. Go to the Dashboard
2. In the "Upcoming Episodes" section, toggle to "Calendar View"
3. Navigate months using the arrow buttons
4. Click on any green-highlighted date to see episodes
5. View episode details in the interactive modal

Calendar Visual Guide

Episode Modal Features

• Show Information: Show title and episode details
• Episode Metadata: Season/episode numbers, titles, air dates
• Scrollable Content: Scroll through multiple episodes
• Multiple Close Options: Click X, close button, press Escape, or click outside
• Responsive Design: Works on desktop and mobile

Export Data

• Complete Backup: All shows, services, and progress
• JSON Format: Human-readable and portable
• Timestamped: Files include export date
• No Data Loss: Everything is preserved

What's Included

• All shows in your watchlist
• Streaming services and subscription status
• Service packages and pricing
• Provider bundles and selections
• Episode and season watch progress
• Show-service relationships

Import Data

Two import modes available:

• Merge Mode: Add new data, update existing
• Replace Mode: Clear existing data first

Import Process

1. Select your JSON export file
2. Choose merge or replace mode
3. Review what will be imported
4. Click import to complete

💰 Save Money

• Regularly review the value analysis to see which services give you the most content per dollar
• Unsubscribe from services with no unwatched shows
• Use the service recommendation to find better alternatives
• Set up free services (YouTube, Pluto TV) to reduce costs
• Track seasonal shows and subscribe only when they're airing

📊 Stay Organized

• Use sorting options to prioritize what to watch next
• Mark episodes as watched to track your progress
• Export your data monthly as backup
• Update streaming service assignments when shows move platforms

🎯 Optimize Usage

• Focus on services with the highest "shows per dollar" ratio
• Consider package downgrades if you don't use premium features
• Group similar shows on the same service to maximize value
• Use the metadata refresh to keep show information current
• Set realistic watching goals based on your history
• Toggle between list and calendar view to find the best way to track episodes
• Use dark mode for comfortable viewing in low light

🔧 Maintenance

• Refresh service prices quarterly to stay current
• Remove completed shows to keep your watchlist manageable
• Update your subscription status when you cancel/add services
• Check for new episodes of ongoing shows regularly
• Use the calendar view to spot gaps in your viewing schedule
• Export data regularly, especially before major updates

Common Issues

Show Search Not Working

• Check your internet connection
• Try a different search term
• The TMDb API might be temporarily unavailable

Streaming Services Not Updating

• Use "Refresh Metadata" on the show details page
• Manually edit streaming services if needed
• Streaming data may vary by region

Import/Export Issues

• Ensure file is valid JSON format
• Check file wasn't corrupted during transfer
• Try exporting again if import fails

Performance Tips

• Large Watchlists: Use sorting and filtering to navigate
• Slow Loading: Close other browser tabs
• Mobile Use: Install as PWA for better performance
• Sync Issues: Refresh the page if data seems outdated

Data Safety

• Export your data regularly as backup
• Don't use replace mode import unless necessary
• Test imports on a copy of your data first
• Keep multiple backup exports