init.yaml.example

# jacred-go configuration example
# Copy to init.yaml and fill in credentials for trackers you want to use.
# Trackers without credentials can still be parsed for publicly available data.

# ── Server ────────────────────────────────────────────────────────────────────

listenip: "127.0.0.1"     # "any" to listen on all interfaces (0.0.0.0)
listenport: 9117

# API key for /api/v1.0/* and /api/v2.0/* endpoints (Jackett/Sonarr/Radarr).
# Leave empty to disable authentication.
apikey: ""

# Key for /dev/* and /cron/* endpoints when accessed from a LAN IP.
# If empty, these endpoints are accessible from any local/private IP without a key.
devkey: ""

# ── Database ──────────────────────────────────────────────────────────────────

# Directory nesting depth for bucket files under Data/fdb/
# 2 (default) creates Data/fdb/ab/cdef…  — recommended for large databases
# 1 creates Data/fdb/a/abcd…
fdbPathLevels: 2

# Merge duplicate entries for the same title from different trackers
mergeduplicates: true
mergenumduplicates: true

# ── Logging ───────────────────────────────────────────────────────────────────

log: true           # General application log to stdout
logParsers: false   # Verbose per-request debug log for parsers
logFdb: false       # Log every FileDB read/write operation

# Per-tracker parse logs written to Data/log/<tracker>.log
logFdbRetentionDays: 7    # Delete log files older than N days (0 = keep forever)
logFdbMaxSizeMb: 100      # Max total size of all log files in MB (0 = unlimited)
logFdbMaxFiles: 0         # Max number of log files per tracker (0 = unlimited)

# ── API access ────────────────────────────────────────────────────────────────

openstats: true       # Enable /stats/* endpoints without API key
opensync: true        # Enable /sync/fdb/torrents (V2 protocol) without API key
opensync_v1: false    # Enable /sync/torrents (V1 legacy protocol) without API key
web: true             # Serve index.html and stats.html

# ── Stats ─────────────────────────────────────────────────────────────────────

timeStatsUpdate: 90   # Rebuild Data/temp/stats.json every N seconds

# ── Memory ────────────────────────────────────────────────────────────────────
# Controls Go runtime memory usage. Useful on VPS with limited RAM.
#
# memlimit: sets a hard cap on the Go heap in MB.
#   When the heap approaches this limit the GC runs very aggressively to stay
#   under it — this prevents OOM-kill at the cost of more CPU for GC.
#   Leave at 0 (disabled) if you have plenty of RAM.
#   Recommended for 2 GB VPS: 1500  (leaves ~500 MB for the OS)
#   Recommended for 1 GB VPS:  700
#
# gcpercent: controls how often the GC runs (Go's GOGC knob).
#   100 = GC when heap doubles since last collection (Go default).
#    50 = GC when heap grows 50% — twice as frequent, lower peak usage.
#    20 = very aggressive; suitable for very tight memory budgets.
#   -1  = disable GC entirely (not recommended).

memlimit: 0       # MB — 0 means no limit
gcpercent: 50     # default 50 (Go's built-in default is 100)

# ── In-memory bucket cache (Evercache) ────────────────────────────────────────
# Keeps recently opened buckets in memory to reduce disk reads on searches.
# The cache is capped at maxOpenWriteTask entries; when full the oldest
# dropCacheTake entries are evicted. Stale entries (older than validHour) are
# swept every 10 minutes by the background evercache cron.

evercache:
  enable: true
  validHour: 1          # Cache TTL in hours; entries older than this are evicted
  maxOpenWriteTask: 500 # Max buckets held in memory (reduce to 200-300 on 1 GB VPS)
  dropCacheTake: 100    # How many buckets to evict when the cap is hit

# ── CloudFlare bypass (flaresolverr-go) ──────────────────────────────────────
# Built-in CF challenge solver — no external Docker service needed.
# Embedded browser solves CF challenges, cookies cached 60 min and reused via
# standard HTTP where possible.
#
# Auto-detect: any tracker that returns a CF challenge during a standard
# request is automatically promoted to flaresolverr routing for future calls;
# the registry persists in Data/temp/cf_auto.json (30-day TTL). Setting
# fetchmode: "flaresolverr" below is now an optional hint that skips the very
# first detection roundtrip for known CF sites (megapeer, bitru, anistar,
# anifilm, mazepa, torrentby).
# Requires Xvfb on headless servers: apt install xvfb

flaresolverr_go:
  headless: true              # true = headless mode, false = visible (needs Xvfb on servers)
  browser_backend: geckodriver # geckodriver (Camoufox, recommended for CF) | chromedriver (Chrome for Testing)
  browser_path: ""            # Browser binary. Empty + geckodriver = auto-download Camoufox (~680 MB, one-time) to ~/.cache. Empty + chromedriver = use system Chrome.
  driver_path: ""             # Custom geckodriver/chromedriver path. Empty = library auto-downloads a matching driver.
  chrome_version: ""          # Pin Chrome for Testing to a major (e.g. "146") — only used with browser_backend: chromedriver. Empty = use system Chrome.

# ── Multi-instance sync ───────────────────────────────────────────────────────
# Pull torrent data from another jacred instance running elsewhere.

syncapi: ""           # URL of remote instance, e.g. "http://192.168.1.10:9117"
timeSync: 60          # Sync interval in seconds
timeSyncSpidr: 60     # Spider (metadata-only) sync interval in seconds
syncsport: true       # Include sport torrents in sync
syncspidr: true       # Enable spider mode (only url/sid/pir, lighter payload)

# Sync only these trackers from the remote (empty list = sync all)
synctrackers: []
#  - "Rutor"
#  - "Kinozal"
#  - "NNMClub"

# Never sync these trackers even if listed on the remote
disable_trackers: []
#  - "Mazepa"

# ── Tracker sections ──────────────────────────────────────────────────────────
# Each section is optional — defaults are used if omitted.
# parseDelay: milliseconds between requests within a single parse call.
#   For trackers with many categories (Rutor=11, Kinozal=25, Rutracker=64+)
#   this prevents rate-limit bans. Set to 0 to disable.
# reqMinute: soft limit on requests per minute (0 = no limit).

# ── Rutor ─────────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: not required
# Parses 11 categories per page call. parseDelay applies between categories.
# Supports: parse?page=N, updatetasksparse, parsealltask, parselatest?pages=N

Rutor:
  host: "https://rutor.is"
  parseDelay: 7000    # ms between category requests (11 categories per parse)
  reqMinute: 8

# ── Megapeer ──────────────────────────────────────────────────────────────────
# Client: standard or flaresolverr  |  Auth: not required
# Supports: parse?maxpage=N

Megapeer:
  host: "https://megapeer.vip"
  fetchmode: "flaresolverr"   # CF-protected, uses flaresolverr-go
  parseDelay: 3000
  reqMinute: 10

# ── TorrentBy ─────────────────────────────────────────────────────────────────
# Client: standard or flaresolverr  |  Auth: not required
# Supports: parse?page=N, updatetasksparse, parsealltask, parselatest?pages=N

TorrentBy:
  host: "https://torrent.by"
  fetchmode: "flaresolverr"   # CF-protected, uses flaresolverr-go
  insecureSkipVerify: true    # torrent.by uses certificate from unknown CA
  parseDelay: 5000
  reqMinute: 8

# ── Kinozal ───────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: LOGIN REQUIRED for magnet links
# Without credentials torrents are fetched but magnets won't be resolved.
# Parses 25 categories × year range. parseDelay critical to avoid bans.
# Supports: parse?page=N, updatetasksparse, parsealltask, parselatest?pages=N

Kinozal:
  host: "https://kinozal.tv"
  parseDelay: 7000
  reqMinute: 6
  login:
    u: ""   # your kinozal.tv username
    p: ""   # your kinozal.tv password

# ── NNMClub ───────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: COOKIE REQUIRED for magnet links
# Without cookie only metadata is available (no magnet).
# Parses 10 categories. Supports task-based parsing.

NNMClub:
  host: "https://nnmclub.to"
  cookie: ""    # Paste full cookie string from browser: "bb_session=…; bb_data=…"
  parseDelay: 5000
  reqMinute: 8

# ── Bitru ─────────────────────────────────────────────────────────────────────
# Client: standard or flaresolverr  |  Auth: not required
# Supports: parse?page=N, updatetasksparse, parsealltask, parselatest?pages=N

Bitru:
  host: "https://bitru.org"
  fetchmode: "flaresolverr"   # CF-protected, uses flaresolverr-go
  parseDelay: 3000
  reqMinute: 10

# ── BitruAPI ──────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: not required (public API)
# API-based, no page scraping. parse?limit=N or parsefromdate?lastnewtor=YYYY-MM-DD

Bitruapi:
  host: "https://bitru.org"
  parseDelay: 0
  reqMinute: 30

# ── Toloka ────────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: login recommended (required for full access)
# Supports task-based parsing.

Toloka:
  host: "https://toloka.to"
  parseDelay: 5000
  reqMinute: 6
  login:
    u: ""   # your toloka.to username
    p: ""   # your toloka.to password

# ── Mazepa ────────────────────────────────────────────────────────────────────
# Client: standard or flaresolverr  |  Auth: login optional
# Parses 47+ categories. High parseDelay recommended.

Mazepa:
  host: "https://mazepa.to"
  fetchmode: "flaresolverr"   # CF-protected, uses flaresolverr-go
  parseDelay: 10000   # many categories — be conservative
  reqMinute: 6
  login:
    u: ""
    p: ""

# ── Rutracker ─────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: LOGIN REQUIRED
# Without login the site returns nothing useful.
# Parses 64+ categories × year range. Very long full parse — use parselatest daily.
# Supports: parse?page=N, updatetasksparse, parsealltask, parselatest?pages=N

Rutracker:
  host: "https://rutracker.org"
  parseDelay: 8000    # strict rate limits — do not lower this
  reqMinute: 6
  login:
    u: ""   # your rutracker.org username
    p: ""   # your rutracker.org password

# ── Selezen ───────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: login optional
# Supports: parse?parseFrom=N&parseTo=M

Selezen:
  host: "https://use.selezen.club"
  parseDelay: 3000
  reqMinute: 10
  login:
    u: ""
    p: ""

# ── Lostfilm ──────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: cookie optional (required for HD quality links)
# Multiple parse modes: parse, parsepages, parseseasonpacks, verifypage

Lostfilm:
  host: "https://www.lostfilm.tv"
  cookie: ""    # optional: "lf_session=…"
  parseDelay: 3000
  reqMinute: 10

# ── Animelayer ────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: login optional
# Supports: parse?maxpage=N

Animelayer:
  host: "https://animelayer.ru"
  parseDelay: 3000
  reqMinute: 10
  login:
    u: ""
    p: ""

# ── Anidub ────────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: not required
# Supports: parse?parseFrom=N&parseTo=M

Anidub:
  host: "https://tr.anidub.com"
  parseDelay: 2000
  reqMinute: 15

# ── Aniliberty ────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: not required (public RSS/API)
# Supports: parse?parseFrom=N&parseTo=M  (response includes lastPage)
# Note: section key is "Aniliberty" but "Anilibria" is also accepted

Aniliberty:
  host: "https://aniliberty.top"
  parseDelay: 1000
  reqMinute: 20

# ── Knaben ────────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: not required (public JSON API)
# API-based search — parseDelay not used between requests.
# parse?from=0&size=300&pages=1&query=…&hours=24&orderBy=date&categories=…

Knaben:
  host: "https://api.knaben.org"
  parseDelay: 0
  reqMinute: 30

# ── Anistar ───────────────────────────────────────────────────────────────────
# Client: standard or flaresolverr  |  Auth: not required
# Supports: parse?limit_page=N  (0 = all pages, default 0)

Anistar:
  host: "https://anistar.org"
  fetchmode: "flaresolverr"   # CF-protected, uses flaresolverr-go
  parseDelay: 3000
  reqMinute: 10

# ── Anifilm ───────────────────────────────────────────────────────────────────
# Client: standard or flaresolverr  |  Auth: not required
# Supports: parse?fullparse=false (incremental) or fullparse=true (all pages)

Anifilm:
  host: "https://anifilm.pro"
  fetchmode: "flaresolverr"   # CF-protected, uses flaresolverr-go
  parseDelay: 3000
  reqMinute: 10

# ── Leproduction ──────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: not required
# Supports: parse?limit_page=N  (0 = all pages, default 0)

Leproduction:
  host: "https://www.le-production.tv"
  parseDelay: 3000
  reqMinute: 10

# ── Baibako ───────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: LOGIN REQUIRED
# Without credentials returns no useful data.
# Supports: parse?maxpage=N  (default 10)

Baibako:
  host: "http://baibako.tv"
  parseDelay: 5000
  reqMinute: 8
  login:
    u: ""   # your baibako.tv username
    p: ""   # your baibako.tv password

# ── Korsars ───────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: LOGIN REQUIRED
# phpBB-mod tracker (films/series/cartoons), magnets inline in listings.
# Without credentials the site won't show torrent metadata.
# 24 categories: 6 films + 12 series + 6 cartoons (forum IDs hardcoded).
# Supports: parse?page=N, updatetasksparse, parsealltask, parselatest?pages=N

Korsars:
  host: "https://korsars.pro"
  parseDelay: 5000
  reqMinute: 8
  login:
    u: ""   # your korsars.pro username
    p: ""   # your korsars.pro password

# ── Ultradox ──────────────────────────────────────────────────────────────────
# Client: standard HTTP  |  Auth: not required
# Listing → detail magnet pull. Each detail page exposes 1–3 quality variants;
# the parser stores one record per variant (sid=1, pir=1 placeholders).
# 6 sections: serial-hd, hd, rufilm, camrip, webrips, anime.
# TLS certificate is currently expired upstream — keep insecureSkipVerify: true
# until they renew.
# Supports: parse?page=N, updatetasksparse, parsealltask, parselatest?pages=N

Ultradox:
  host: "https://ultradox.top"
  insecureSkipVerify: true
  parseDelay: 5000
  reqMinute: 8

# ── Proxy ─────────────────────────────────────────────────────────────────────
# Route specific tracker requests through a proxy.
# Set useproxy: true on the tracker section to activate.
# "pattern" is a regex matched against the tracker host URL.

# globalproxy:
#   - pattern: "\.onion"
#     list:
#       - "socks5://127.0.0.1:9050"
#     useAuth: false
#     BypassOnLocal: true
#     username: ""
#     password: ""