SeerrBridge

To automate movie requests, configure Jellyseerr or Overseerr to send webhooks to SeerrBridge.

1. Webhook URL: Set the webhook URL to http://localhost:8777/jellyseer-webhook/ (or http://seerrbridge:8777/jellyseer-webhook/ if both are in the same Docker network).
2. Notification Type: Set notifications to "Request Automatically Approved".
3. User Settings: Ensure the user is set to automatic approvals.
4. Payload: The JSON payload must follow the specific structure required by SeerrBridge to parse media and request details correctly.

{
    "notification_type": "{{notification_type}}",
    "event": "{{event}}",
    "subject": "{{subject}}",
    "message": "{{message}}",
    "image": "{{image}}",
    "{{media}}": {
        "media_type": "{{media_type}}",
        "tmdbId": "{{media_tmdbid}}",
        "tvdbId": "{{media_tvdbid}}",
        "status": "{{media_status}}",
        "status4k": "{{media_status4k}}"
    },
    "{{request}}": {
        "request_id": "{{request_id}}",
        "requestedBy_email": "{{requestedBy_email}}",
        "requestedBy_username": "{{requestedBy_username}}",
        "requestedBy_avatar": "{{requestedBy_avatar}}",
        "requestedBy_settings_discordId": "{{requestedBy_settings_discordId}}",
        "requestedBy_settings_telegramChatId": "{{requestedBy_settings_telegramChatId}}"
    },
    "{{issue}}": {
        "issue_id": "{{issue_id}}",
        "issue_type": "{{issue_type}}",
        "issue_status": "{{issue_status}}",
        "reportedBy_email": "{{reportedBy_email}}",
        "reportedBy_username": "{{reportedBy_username}}",
        "reportedBy_avatar": "{{reportedBy_avatar}}",
        "reportedBy_settings_discordId": "{{reportedBy_settings_discordId}}",
        "reportedBy_settings_telegramChatId": "{{reportedBy_settings_telegramChatId}}"
    },
    "{{comment}}": {
        "comment_message": "{{comment_message}}",
        "commentedBy_email": "{{commentedBy_email}}",
        "commentedBy_username": "{{commentedBy_username}}",
        "commentedBy_avatar": "{{commentedBy_avatar}}",
        "commentedBy_settings_discordId": "{{commentedBy_settings_discordId}}",
        "commentedBy_settings_telegramChatId": "{{commentedBy_settings_telegramChatId}}"
    },
    "{{extra}}": []
}

The process_tv_show_seasons function performs deep validation of requested TV seasons to ensure data consistency between Trakt and the local database.

Logic Flow:

1. Discrepancy Check: It checks if the specific (show, season) pair is already recorded in the DISCREPANCY_REPO_FILE to avoid redundant processing.
2. Trakt Fetching: Retrieves episode_count and aired_episodes for the season from Trakt.
3. Discrepancy Detection:
   • A real discrepancy is defined as aired_episodes > episode_count (indicating a data error where more episodes are marked aired than exist in the season metadata).
   • Note: episode_count > aired_episodes is considered normal for in-progress seasons and is not marked as a discrepancy.
4. Error Logging: If a real discrepancy is found, the details are appended to the DISCREPANCY_REPO_FILE (JSON format) for tracking.
5. Database Update: Uses EnhancedSeasonManager.update_tv_show_seasons to persist the validated season data (including unprocessed_episodes, status, and is_discrepant flags) to the database.

async def process_tv_show_seasons(
    media_title: str, 
    requested_seasons: List[str], 
    media_details: Dict[str, Any], 
    tmdb_id: int, 
    imdb_id: str, 
    request_id: int
) -> None:

SeerrBridge can be deployed as a unified container that includes a MySQL database, a Python backend, and a Nuxt frontend. The image is hosted on the GitHub Container Registry (ghcr.io/woahai321/seerrbridge:latest).

Important Note on Configuration: While the Docker Compose file defines database and network settings, all application-level configuration (such as API keys, tokens, and advanced settings) is managed via the web interface and stored in the ./data/.env file.

services:
  seerrbridge:
    image: ghcr.io/woahai321/seerrbridge:latest
    container_name: seerrbridge
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-seerrbridge_root}
      DB_HOST: localhost
      DB_PORT: 3306
      DB_NAME: ${DB_NAME:-seerrbridge}
      DB_USER: ${DB_USER:-seerrbridge}
      DB_PASSWORD: ${DB_PASSWORD:-seerrbridge}
      USE_DATABASE: "true"
      NUXT_PORT: 3777
    ports:
      - "3307:3306"  # MySQL
      - "3777:3777"  # Nuxt frontend
      - "8777:8777"  # SeerrBridge API
      - "8778:8778"  # Setup API server
    volumes:
      - mysql_data:/var/lib/mysql
      - ./logs:/app/logs
      - ./data:/app/data

volumes:
  mysql_data:
    driver: local
    name: seerrbridge_mysql_data

The app.config.ts file allows you to customize the visual identity of the SeerrBridge Dashboard. You can modify the application metadata, the color theme, and the UI color palette.

App Metadata

• name: The display name of the application.
• description: A brief description of the dashboard's purpose.

Theme Configuration

• theme.primary: The primary color used for branding (e.g., 'purple').
• theme.darkMode: Controls how dark mode is applied. Setting this to 'class' enables dark mode via a CSS class.

UI Configuration

• ui.primary: The primary color for UI components.
• ui.gray: The shade of gray used for neutral elements (e.g., 'slate').

export default defineAppConfig({
  // App configuration
  name: 'DarthVadarr',
  description: 'SeerrBridge Dashboard - Monitor and manage your SeerrBridge service',

// Theme configuration
  theme: {
    primary: 'purple',
    darkMode: 'class'
  },

// UI configuration
  ui: {
    primary: 'purple',
    gray: 'slate'
  }
})

The /jellyseer-webhook/ POST endpoint processes incoming webhooks from Jellyseerr or Overseerr.

Workflow:

1. Payload Parsing: Parses the JSON payload into a WebhookPayload model.
2. Media Enrichment: Fetches detailed media information (title, year, IMDb ID, Trakt ID) from Trakt using the provided TMDB ID.
3. Queueing:
   • For movies: Adds the request to the movie queue via add_movie_to_queue.
   • For TV shows: Extracts requested seasons (supporting both integer arrays and string formats like Season X), adds the request to the TV queue via add_tv_to_queue, and triggers process_tv_show_seasons for comprehensive season validation.
4. Tracking: If USE_DATABASE is enabled, it starts media processing tracking and caches images via fetch_and_cache_images_if_needed.

Note: A TEST_NOTIFICATION event type is supported for testing the webhook integration.

POST /jellyseer-webhook/

Payload must include:
- `media`: object containing `tmdbId`, `media_type`, etc.
- `request`: object containing `request_id`, `requestedBy_username`.
- `extra`: list of objects (can contain `requested_seasons`).