PLAXT
Get Started

Lampa Setup

Connect your Lampa app to sync watch activity to your tracking services.

What is Lampa?

Lampa is a client-side TMDB-based media browser. With the Plaxt plugin installed, Lampa sends playback events (play, pause, stop) to Plaxt whenever you watch something.

Prerequisites

  • The Lampa app installed on your device
  • The Plaxt plugin for Lampa

Connecting Lampa

  1. Go to Connections in the Plaxt dashboard
  2. Click Connect Lampa
  3. Optionally set a display name for this connection
  4. Click Connect

No credentials are needed — Lampa connections work via webhooks.

Setting Up the Plugin

After connecting Lampa in Plaxt:

  1. Create a sync link with Lampa as the source
  2. Copy the webhook URL from your sync link settings (e.g., https://your-plaxt-instance.com/api/webhooks/lampa/<your-webhook-token>)
  3. In the Lampa app, install and configure the Plaxt plugin
  4. Paste your webhook URL into the plugin settings

The plugin will send playback events to Plaxt whenever you play, pause, or stop media.

What Gets Synced

Lampa sends the following data with each event:

  • Movies — Title, TMDB ID, IMDb ID (if available), year
  • TV Episodes — Show name, season, episode, TMDB ID
  • Playback progress — Percentage watched (0–100%)
  • Events — Start, pause, stop, and progress updates

Limitations

  • One connection per account — Only one Lampa connection can exist per Plaxt account
  • No history sync — Lampa only sends real-time events, there is no watch history to backfill
  • Plugin required — The Plaxt plugin must be installed in Lampa for events to be sent

Troubleshooting

Events not appearing

  1. Verify the webhook URL is correctly configured in the Lampa plugin
  2. Check that your Plaxt instance is accessible from your device
  3. Review the event log in your sync link for errors

Wrong media matched

  1. Lampa uses TMDB IDs as the primary identifier — matching is generally accurate
  2. If an IMDb ID is available, it will be used for better matching on the destination

Best Practices

  • Keep the Lampa plugin updated for the best compatibility
  • Use the event log in Plaxt to verify events are flowing correctly
Back to Docs