Product Hunt 🎉 We are featured on Product Hunt! Use code for 1,000 free execution credits.
Tutorial

How to Share Trakt Movie History on Nostr

Log your movie and TV show watch history seamlessly to your Nostr feed using Trakt.tv webhooks.

Are you a cinephile who uses Trakt to keep a detailed diary of every movie and TV episode you watch? By connecting Trakt to Nostr via NostrBridge, you can automatically share your reviews and watch history with your decentralized followers, sparking conversations about the latest shows.

In this tutorial, we will configure NostrBridge to parse Trakt.tv webhook payloads and publish beautifully formatted notes to Nostr.

Prerequisites

  • A Trakt.tv account (Trakt VIP is required for native webhooks, or you can use a bridge service).
  • A NostrBridge account.

Step 1: Create a Rule in NostrBridge

  1. Log into the NostrBridge Client Dashboard.
  2. Click on Create New Rule.
  3. Under Provider Selection, choose Trakt.tv.
  4. Set the Event Kind to Kind 1 (Short Text Note).
  5. Choose your preferred signing method.

Step 2: Configure the Message Template

The template determines how your note will look on Nostr. In the template editor, you can write something like this:

🎬 Just watched: {{ payload.movie.title }} ({{ payload.movie.year }})

Tracked via Trakt.tv! 🍿
#nowwatching #movies #nostr

If you are also tracking TV Shows, you can use Liquid conditionals to handle both movies and episodes:

{% if payload.movie %}
🎬 Just watched the movie: {{ payload.movie.title }} ({{ payload.movie.year }})
{% elsif payload.episode %}
📺 Watching: {{ payload.show.title }} - Season {{ payload.episode.season }}, Ep {{ payload.episode.number }} ({{ payload.episode.title }})
{% endif %}

#trakt #nowwatching

Step 3: Setup the Trakt Webhook

Now you need to point Trakt.tv to NostrBridge.

  1. Copy your unique NostrBridge Endpoint URL from your rule dashboard.
  2. Go to your Trakt.tv settings and navigate to the Webhooks section (Note: Trakt VIP is required).
  3. Click Add a Webhook.
  4. Paste the NostrBridge Endpoint URL into the URL field.
  5. Ensure the format is set to JSON.
  6. Select the events you want to trigger the webhook (e.g., Scrobbles, Checkins, Ratings).
  7. Save the webhook.

Don't have Trakt VIP? You can achieve similar results using the free RSS feeds provided by Trakt. Set up a NostrBridge Custom Webhook / RSS rule, and use a free service like IFTTT or Zapier to parse your Trakt RSS feed and send HTTP POST requests to your NostrBridge URL.

Step 4: Watch and Share!

The next time you finish watching a movie or checking into a show on Trakt, the data is instantly forwarded to NostrBridge, converted to your custom template, and broadcast to the Nostr network.

Ready to automate Nostr?

Join NostrBridge today and connect your favorite apps.

Start Bridging for Free