Help & Setup Guide

Everything you need to get Sync View working with your browser and Discord.

On this page

Prerequisites

Before you begin, make sure you have:

  • Windows 10 or 11
  • Discord desktop app installed and running (the web version does not support Rich Presence)
  • A supported browser: Firefox (v142+), Chrome (v130+), or Microsoft Edge (v130+)

Step 1: Install the Companion App

Sync View requires a small companion app (SyncView.exe) that runs on your computer. This app bridges your browser and Discord.

Option A: Use the Installer (Recommended)

  1. Download SyncView-Setup-3.1.0.exe from the Releases page
  2. Run the installer
  3. Check the boxes for:
    • "Register native messaging host (Firefox, Chrome, Edge)" — required for browser communication
    • "Start with Windows" — optional, keeps Sync View running
  4. Click Install

Option B: Manual Setup

  1. Download and extract the latest release zip
  2. Run SyncView.exe — the setup wizard will guide you through registration
  3. The wizard creates the native messaging manifests and registry entries for all browsers

Step 2a: Firefox Setup

Install from File

  1. Open Firefox and go to about:addons
  2. Click the gear icon in the top-right
  3. Select "Install Add-on From File..."
  4. Navigate to your install directory and select sync-view.xpi

Note: Unsigned Extensions

Installing unsigned .xpi files requires Firefox Developer Edition, Nightly, or ESR. In about:config, set xpinstall.signatures.required to false. Standard Firefox will block unsigned extensions.

For Development (Temporary)

  1. Open about:debugging#/runtime/this-firefox
  2. Click "Load Temporary Add-on..."
  3. Select manifest.json from the project root
  4. The extension will be active until Firefox restarts

Firefox setup is complete! No additional configuration needed — the native messaging host is registered automatically by the installer or setup wizard.

Step 2b: Chrome Setup

Load the Extension

  1. Open Chrome and go to chrome://extensions/
  2. Enable Developer mode using the toggle in the top-right corner
  3. Click "Load unpacked"
  4. Select the chrome/ folder from the project (or dist/extension-chrome/ after building)
  5. The extension will appear in your extensions list

Register the Extension ID

Chrome requires the extension ID to be explicitly allowed in the native messaging host manifest. This is an extra step compared to Firefox.

  1. On the chrome://extensions/ page, find the Sync View extension
  2. Copy the extension ID — it's the long string shown below the extension name (e.g., abcdefghijklmnopqrstuvwxyzabcdef)
  3. Open SyncView.exe
  4. Click the gear icon to open Settings
  5. Paste the extension ID into the "Chrome / Edge Extension IDs" field
  6. Click "Save IDs"

Why is this step needed?

Chrome's native messaging security model requires each extension to be explicitly allowed by ID. Firefox uses extension names instead, so this step is automatic. The ID changes if you reload the extension from a different folder, so you may need to update it.

Step 2c: Edge Setup

Load the Extension

  1. Open Edge and go to edge://extensions/
  2. Enable Developer mode using the toggle in the bottom-left
  3. Click "Load unpacked"
  4. Select the edge/ folder from the project (or dist/extension-edge/ after building)

Register the Extension ID

Edge uses the same Chromium native messaging model as Chrome, so the same registration step applies.

  1. On the edge://extensions/ page, copy the Sync View extension ID
  2. Open SyncView.exe → Settings
  3. Paste the ID into "Chrome / Edge Extension IDs" (comma-separate if you already have a Chrome ID)
  4. Click "Save IDs"

Using both Chrome and Edge?

You can enter multiple extension IDs separated by commas. Both browser extensions will work simultaneously.

Step 3: Verify It Works

  1. Make sure Discord is running (desktop app, not web)
  2. Make sure SyncView.exe has been run at least once
  3. Open a supported streaming site in your browser (e.g., YouTube)
  4. Play a video or song
  5. Check the Sync View extension popup — it should show "Connected to Discord" and the current media
  6. Ask a friend to check your Discord profile — they should see your Rich Presence status

Rich Presence is not visible to yourself

Discord does not show your own Rich Presence status to you. You need a second account or a friend to verify it's working. The Sync View popup and SyncView.exe activity log are the best way to confirm locally.

How It Works

Sync View has three components that work together:

Browser Extension

A content script runs on supported streaming sites and extracts metadata — title, artist/channel, playback progress, thumbnails, and live status. It uses the Media Session API where available, with DOM selector fallbacks for reliability. The extension sends this data to the native messaging host.

syncviewhost.exe (Native Messaging Host)

A headless process that the browser launches automatically via the native messaging protocol. It receives media data from the extension via stdin/stdout and forwards it to Discord's local IPC named pipe. This is the bridge between your browser and Discord.

SyncView.exe (Companion App)

A desktop GUI app that handles first-time setup, registers the native messaging host in the Windows registry, and provides settings, an activity log, and connection monitoring. It also checks for updates.

All communication is 100% local. No data is sent to any server — your browser talks to a local process, which talks to Discord via a local pipe.

Settings & Configuration

Open SyncView.exe and click the gear icon to access settings.

Start with Windows

Automatically launch SyncView when you log in. Useful if you always want Rich Presence active.

Minimize to System Tray

When you close the window, SyncView minimizes to the system tray instead of exiting. It keeps running in the background.

Start Minimized

Launch directly to the system tray without showing the window. Best used with "Start with Windows".

Chrome / Edge Extension IDs

Enter your Chrome and/or Edge extension IDs here. This is required for Chromium-based browsers to communicate with the native messaging host. Separate multiple IDs with commas.

Re-register Native Host

Re-creates the native messaging manifest files and updates the Windows registry entries for all browsers. Use this if you moved the install directory or if the native host connection is broken.

Configuration is stored at %APPDATA%\SyncView\config.json.

Troubleshooting

Extension popup says "Disconnected"

  • Make sure Discord desktop app is running
  • Run SyncView.exe at least once to register the native host
  • Click Reconnect in the SyncView app
  • Verify syncviewhost.exe exists in the same directory as SyncView.exe

Chrome/Edge: "Specified native messaging host not found"

  • Open SyncView.exe → Settings
  • Paste your extension ID into "Chrome / Edge Extension IDs" and click "Save IDs"
  • Your extension ID is on chrome://extensions/ or edge://extensions/
  • After saving, reload the extension in your browser

Rich Presence doesn't appear on Discord

  • Go to Discord Settings → Activity Privacy → enable "Display current activity as a status message"
  • Rich Presence is not visible to yourself — ask a friend to check, or use a second account
  • Make sure the media is actually playing (paused content may clear the status after a delay)
  • Check that the Discord Application ID is valid — the default is 1482383187882545233

Native host not found (Firefox)

  • Open SyncView → Settings → click "Re-register Native Host"
  • Verify the registry key: HKCU\Software\Mozilla\NativeMessagingHosts\youtube_discord_rpc
  • The manifest's path field must point to the actual location of syncviewhost.exe

Extension doesn't detect media

  • Confirm you're on a supported site (YouTube, Netflix, Spotify, etc.)
  • Wait a few seconds after the page loads — the content script runs at document_idle
  • Some DRM-protected players may limit metadata availability
  • Make sure the extension is enabled and has the required permissions

SyncView.exe shows "No media playing" even when playing

  • The "Now Playing" display reads state from syncviewhost.exe via a shared file
  • Make sure the extension is connected — check the browser extension popup
  • The display updates every 3 seconds

FAQ

Is my data sent anywhere?

No. Sync View is 100% local. Your browser extension talks to a local process via native messaging (stdin/stdout), which then talks to Discord via a local named pipe. No data ever leaves your machine.

Do I need to keep SyncView.exe running?

No. SyncView.exe is only needed for first-time setup and configuration. The browser extension communicates directly with syncviewhost.exe, which the browser launches automatically when needed.

Can I use multiple browsers at the same time?

Yes! Each browser launches its own instance of the native messaging host. However, Discord only shows one Rich Presence status at a time — the last browser to send an update wins.

Does it work with Discord web?

No. Discord Rich Presence only works with the Discord desktop app. The web version does not support local IPC connections.

Can other people see what I'm watching?

Yes, that's the point! Your Discord Rich Presence is visible to friends and anyone who can see your profile. If you want to stop sharing, simply pause the media or disable the extension. You can also disable Rich Presence in Discord Settings → Activity Privacy.

Why does the Chrome extension need an extra setup step?

Chrome and Edge use a stricter security model for native messaging. Each extension must be explicitly allowed by its unique ID. Firefox uses a different mechanism (extension names) that doesn't require this step.

Is it open source?

Yes! Sync View is MIT licensed and fully open source. View the code, report issues, or contribute on GitHub.