Jobs Overview

Jobs are automated tasks that fetch content from Trakt and add it to your media library on a schedule.

Available Job Types

17 Jobs 9 Categories

Trending

trending_moviestrending_shows

What’s hot right now - current buzz and viral content.

Update frequency: Every 6 hours

Popular

popular_moviespopular_shows

Most watched content over the past week.

Update frequency: Daily

Smart Popular

smart_popular_moviessmart_popular_shows

Adaptive scoring - balances mainstream blockbusters with quality control.

Update frequency: Daily

Box Office

box_office

Current theatrical box office hits.

Update frequency: Weekly

Anticipated

anticipated_moviesanticipated_shows

Most anticipated upcoming releases.

Update frequency: Weekly

Favorited

favorited_moviesfavorited_shows

Most favorited by community.

Update frequency: Daily

Played

played_moviesplayed_shows

Most played (total plays, rewatchable).

Update frequency: Daily

Watched

watched_movieswatched_shows

Most watched by unique users.

Update frequency: Daily

Collected

collected_moviescollected_shows

Most collected in user libraries (essentials).

Update frequency: Weekly

Dynamic Job System

New in v1.4.0

Create custom jobs with full control over type, media, limits, and settings - all from the UI.

Creating Jobs

From Template

1. Navigate to Jobs page
2. Click Add Job
3. Select Movies or TV Shows tab
4. Click a template card (e.g., “Trending Movies”)
5. Job is created with sensible defaults
6. Click the job card to customize settings

Custom Job

1. Navigate to Jobs page
2. Click Add Job
3. Select Custom tab
4. Fill in:
   • Name - Descriptive name for your job
   • Type - trending, popular, watched, etc.
   • Media - Movies or Shows
   • Limit - How many items to fetch (up to 1000)
   • Period - Required for watched/collected/favorited/played
5. Click Create Job
6. Configure advanced settings as needed

Job Templates

16 pre-configured templates to get you started:

Movies	TV Shows
Trending Movies	Trending Shows
Popular Movies	Popular Shows
Anticipated Movies	Anticipated Shows
Favorited Movies	Favorited Shows
Watched Movies	Watched Shows
Collected Movies	Collected Shows
Box Office	-
Smart Popular Movies	Smart Popular Shows

Content Limits

Tip

Jobs can now fetch up to 1000 items per run (was 100). Trakt API pagination is handled automatically.

Job Type	Default	Maximum
Trending	50	1000
Popular	50	1000
Watched/Collected/etc.	50	1000
Box Office	10	10
Smart Popular	50	1000

Migrating Legacy Jobs

If you have jobs configured in your config.yaml, a migration banner appears on the Jobs page.

1. Click Migrate Jobs in the banner
2. Legacy jobs are converted to dynamic format
3. All settings (schedule, limits, filters) are preserved
4. Legacy config remains as backup (no longer used)

Note

Migration is optional. Legacy jobs continue to work - you can migrate when ready.

Job Configuration

Legacy Format

Jobs defined directly in config (pre-v1.4.0):

jobs:
  sync_interval: "6h"     # Default interval for all jobs
  mode: "direct"          # direct or jellyseerr

  trending_movies:
    enabled: true
    limit: 20
    sync_interval: "6h"   # Override default
    mode: "direct"
    minimum_availability: "released"
    monitor: "movieOnly"

  popular_shows:
    enabled: true
    limit: 30
    monitor: "all"

Dynamic Format

Dynamic jobs (v1.4.0+) - defined in jobs.list:

jobs:
  sync_interval: "6h"
  mode: "direct"

  list:
    - id: "my-trending-movies"
      name: "My Trending Movies"
      enabled: true
      type: "trending"
      source: "trakt"
      media: "movie"
      limit: 50
      sync_interval: "6h"
      mode: "direct"
      minimum_availability: "released"
      monitor: "movieOnly"

    - id: "weekly-watched"
      name: "Weekly Most Watched"
      enabled: true
      type: "watched"
      source: "trakt"
      media: "movie"
      limit: 30
      period: "weekly"

Smart Job

Smart job with adaptive thresholds:

jobs:
  list:
    - id: "smart-movies"
      name: "Smart Popular Movies"
      enabled: true
      type: "smart_popular"
      source: "trakt"
      media: "movie"
      limit: 50
      base_min_rating: 6.0       # Base rating threshold
      adjustment_factor: 0.5     # Popularity adjustment (0.1-1.0)

See Smart Jobs for details.

Configuration Options

Option	Type	Required	Description
id	string	No	Unique identifier (auto-generated if omitted)
name	string	Yes	Display name for the job
enabled	boolean	Yes	Enable or disable the job
type	string	Yes	Job type: trending, popular, watched, collected, favorited, played, anticipated, box_office, smart_popular
media	string	Yes	"movie" or "show"
limit	integer	No	Max items to fetch (defaults to job type default)
period	string	No	Time period for watched/collected/favorited/played: weekly, monthly, yearly, all
sync_interval	string	No	Custom sync interval (e.g., 6h, 12h, 24h)
mode	string	No	Override global mode: direct or jellyseerr
minimum_availability	string	No	For Radarr: announced, in_cinemas, released
monitor	string	No	Monitor setting for Radarr/Sonarr
base_min_rating	float	No	Smart jobs: base rating threshold
adjustment_factor	float	No	Smart jobs: popularity adjustment

Scheduling

Jobs run on a configurable interval using duration strings.

Interval Format

The sync_interval field uses Go duration format:

Value	Meaning
1h	Every hour
6h	Every 6 hours
12h	Every 12 hours
24h	Once per day
168h	Once per week (7 days)

Recommended Intervals

Job Type	Recommended Interval	Reason
Trending	6h	Changes frequently
Popular	12h - 24h	Updates daily
Watched/Collected/etc.	24h	Aggregated data, slower updates
Box Office	24h - 168h	Weekly data
Anticipated	24h	Upcoming releases
Smart Popular	12h - 24h	Adaptive filtering

Best Practices

Use different intervals per job:

jobs:
  list:
    - id: "trending-movies"
      name: "Trending Movies"
      type: "trending"
      media: "movie"
      sync_interval: "6h"    # Check frequently
      # ...

    - id: "popular-movies"
      name: "Popular Movies"
      type: "popular"
      media: "movie"
      sync_interval: "12h"   # Less frequent
      # ...

    - id: "weekly-watched"
      name: "Weekly Watched"
      type: "watched"
      media: "movie"
      period: "weekly"
      sync_interval: "24h"   # Once per day
      # ...

Tip

Jobs with longer intervals reduce API calls and server load while still catching new content.

Job Workflow

1. Fetch from Trakt

   Job contacts Trakt API and retrieves the specified list (trending, popular, etc.) up to the configured limit

2. Apply Filters

   Content is filtered based on your global filter criteria (ratings, genres, countries, languages, runtime, etc.)

3. Fetch Metadata

   Retrieve TMDB metadata for poster images and additional details

4. Check Existing

   Skip content already in Radarr/Sonarr or Jellyseerr

5. Add Content

   Send to Radarr/Sonarr (direct mode) or create Jellyseerr request

6. Log Activity

   Record what was added/filtered in the activity log

Preview Jobs

Always Preview First

Use the preview feature to see what will be added before enabling a job.

Web UI

1. Navigate to Jobs page
2. Configure your job settings
3. Click Preview button
4. Review the results:
   • ✅ Items that will be added
   • ⚠️ Items filtered out (with reasons)
   • ℹ️ Items already in library
5. Adjust filters/scoring as needed
6. Enable when satisfied

API

# Preview a job
curl -X POST http://localhost:9090/api/v1/jobs/preview/trending-movies

# Response
{
  "would_add": [
    {
      "title": "Dune: Part Two",
      "year": 2024,
      "score": 87,
      "reason": "Passes all filters"
    }
  ],
  "filtered_out": [
    {
      "title": "Low Budget Horror",
      "year": 2024,
      "score": 45,
      "reason": "Score below threshold (65)"
    }
  ],
  "already_in_library": [
    {
      "title": "The Batman",
      "year": 2022
    }
  ],
  "stats": {
    "total_fetched": 50,
    "would_add": 8,
    "filtered_out": 35,
    "already_added": 7
  }
}

Manual Triggering

Web UI

Click the ▶ Run Now button next to any enabled job to trigger it immediately.

API

curl -X POST http://localhost:9090/api/v1/jobs/trigger/trending-movies

Note

Manual triggers ignore the schedule but respect all filters, scoring, and thresholds.

Job Comparison

By Freshness

Job Type	Update Speed	Best For
Trending	Every 6 hours	Latest buzz, viral moments
Popular	Daily	Current favorites
Box Office	Weekly	Theatrical releases
Anticipated	Weekly	Future releases

By Quality

Job Type	Quality Level	Volume
Smart Popular	High (adaptive)	Medium
Favorited	High (community-vetted)	Low-Medium
Watched	Medium-High (proven)	Medium
Trending	Variable	High

By Use Case

For Current Events:

• Trending (every 6 hours)
• Popular (daily)

For Quality Curation:

• Smart Popular (adaptive thresholds)
• Favorited (community favorites)
• Watched (proven completion)

For Completionism:

• Collected (essentials)
• Popular + Trending (high volume)

For Future Planning:

• Anticipated (upcoming)
• Box Office (new releases)

Example Configurations

Balanced

Goal: Good mix of current and quality content.

jobs:
  sync_interval: "6h"
  mode: "direct"

  list:
    - id: "trending-movies"
      name: "Trending Movies"
      enabled: true
      type: "trending"
      media: "movie"
      limit: 50
      sync_interval: "6h"

    - id: "smart-popular-movies"
      name: "Smart Popular Movies"
      enabled: true
      type: "smart_popular"
      media: "movie"
      limit: 30
      sync_interval: "12h"
      base_min_rating: 6.5
      adjustment_factor: 0.5

    - id: "favorited-movies"
      name: "Favorited Movies"
      enabled: true
      type: "favorited"
      media: "movie"
      limit: 20
      period: "weekly"
      sync_interval: "24h"

Result: ~10-15 movies/week, mix of current and quality

Quality Focus

Goal: Only the best content with smart filtering.

jobs:
  list:
    - id: "smart-movies"
      name: "Smart Popular Movies"
      enabled: true
      type: "smart_popular"
      media: "movie"
      limit: 100
      sync_interval: "24h"
      base_min_rating: 7.0     # Higher rating bar
      adjustment_factor: 0.3   # Less adjustment for popularity

    - id: "all-time-favorites"
      name: "All-Time Favorites"
      enabled: true
      type: "favorited"
      media: "movie"
      limit: 50
      period: "all"
      sync_interval: "168h"    # Weekly

Result: ~5-8 excellent movies/week

High Volume

Goal: Catch everything trending.

jobs:
  list:
    - id: "trending-movies"
      name: "Trending Movies"
      enabled: true
      type: "trending"
      media: "movie"
      limit: 200
      sync_interval: "6h"

    - id: "popular-movies"
      name: "Popular Movies"
      enabled: true
      type: "popular"
      media: "movie"
      limit: 150
      sync_interval: "12h"

    - id: "trending-shows"
      name: "Trending Shows"
      enabled: true
      type: "trending"
      media: "show"
      limit: 100
      sync_interval: "6h"

Result: High volume (requires storage!)

Best Practices

Start Conservative

Begin with strict global filters (min_rating, min_votes), then relax as needed.

Preview Everything

Always preview jobs before enabling to avoid unwanted content.

Use Different Intervals

Use longer sync_intervals for slower-updating lists (collected, anticipated).

Monitor Activity

Check the Activity log weekly to see what’s being added.

Use Smart Jobs

Smart Popular jobs automatically balance quality and popularity.

Set Reasonable Limits

Start with lower limits (20-50) and increase gradually.

Troubleshooting

No Content Being Added?

Common issues:

• Global filters too strict (check min_rating, min_votes in filters section)
• Content already in library (check activity log)
• Job not enabled (verify enabled: true)
• Trakt API not configured (check Trakt credentials)
• Period required but not set (for watched/collected/favorited/played jobs)

Next Steps

Filters & Scoring

Configure filtering and scoring rules

Smart Jobs

Learn about adaptive smart jobs

Integration Modes

Choose Direct or Jellyseerr mode

Use Cases

See real-world examples