👋 Start here - setup help, FAQ & where to post

[ZL154]

Welcome to StarTrack discussions! ⭐

Letterboxd-style star ratings for Jellyfin, with two-way sync to Trakt / Simkl / Letterboxd / Yamtrack. This is the place for setup help, questions, and ideas.

❓ Quick FAQ

External sync isn't pulling/pushing ratings
Make sure the service is connected in the plugin settings and your token/credentials are valid. The first sync also runs a backfill of your existing ratings - give it time on large libraries.

Sync returns 403 / "forbidden" (Trakt/Simkl behind Cloudflare)
Some endpoints reject requests without a proper User-Agent. The plugin sets one - if you're proxying, don't strip or override the User-Agent header.

Ratings show on movies but not episodes (or vice-versa)
Episodes and movies/shows are tracked in separate buckets, and not every service supports every level (e.g. Letterboxd is films-only). Rate at the level the remote service actually supports.

Two-way sync overwrote some ratings
With two-way sync, the most recent change wins. For a one-time migration, set the direction to import-only first, verify it looks right, then switch to two-way.

Yamtrack
Supported via CSV import in the plugin settings.

🗂️ Where to post

• ❓ Q&A - setup / "how do I sync…" / usage help
• 💡 Ideas - feature requests
• 🐛 Bugs → please open an Issue (with logs + version), not a discussion

Thanks for using StarTrack — if it's useful to you, ⭐ the repo or sponsor / buy me a coffee