Diffvideo/Docs

GitHub Integration

Diffvideo connects to GitHub through a GitHub App that receives webhook events and reads repository data. This page covers the integration architecture, permissions, and troubleshooting.

How it works

The Diffvideo GitHub App is installed on your GitHub organization or personal account. When installed, GitHub sends webhook events to Diffvideo whenever activity occurs on your selected repositories. Diffvideo processes these events and generates video suggestions or autonomous videos based on your configured rules.

Permissions

The GitHub App requests the minimum permissions necessary to monitor repository activity and read code changes:

  • Repository contents (read-only) — Read file diffs, commit contents, and tree structures for automated video generation.
  • Pull requests (read-only) — Receive PR merge events, read PR titles, descriptions, and metadata.
  • Metadata (read-only) — Repository names, default branches, and basic configuration.
  • Webhooks — Receive event notifications from GitHub when activity occurs.
Diffvideo never requests write access to your repositories. It cannot create branches, modify files, post comments, or change any repository settings. See Privacy policy for details on data handling.

Webhook events

Diffvideo listens for the following GitHub webhook events:

  • pull_request — Triggered when a PR is opened, updated, or merged. Diffvideo primarily processes merged events for video generation.
  • push — Triggered when commits are pushed to a branch. Used for monitoring main/default branch activity.
  • release — Triggered when a new release is published. Used for release-triggered video generation.
  • issue_comment — Triggered when a comment mentions Diffvideo. Used for comment-mention triggered video generation.

Installation

To install the Diffvideo GitHub App:

  1. Sign in to your Diffvideo dashboard and navigate to Settings → Integrations.
  2. Click Connect GitHub to start the GitHub App installation flow.
  3. Choose your GitHub organization or personal account.
  4. Select which repositories to grant access to — you can choose all repositories or select specific ones.
  5. Confirm the installation. You'll be redirected back to Diffvideo.

After installation, your repositories appear in the Diffvideo dashboard and begin receiving webhook events immediately.

Managing repository access

You can change which repositories Diffvideo has access to at any time:

  • From GitHub — Go to your GitHub organization or account settings → Installed GitHub Apps → Diffvideo → Repository access.
  • From Diffvideo — Navigate to Settings → Integrations to see connected repositories and manage their configuration.

Troubleshooting

Repository not appearing in dashboard

If a repository doesn't appear after installation, check that the GitHub App has been granted access to that specific repository. Go to your GitHub organization settings → Installed GitHub Apps → Diffvideo and verify the repository is in the access list.

Events not triggering video generation

If events aren't triggering video generation, verify:

  • The repository is connected and active in your Diffvideo dashboard
  • You have an active rule that matches the event type (see Rules Engine)
  • The GitHub App is still installed — check GitHub settings if you're unsure
  • You haven't exceeded your plan's included minutes (see Billing in settings)

Reinstalling the GitHub App

If you need to reinstall the GitHub App (e.g., after a permissions change), uninstall it from GitHub first, then reinstall from the Diffvideo dashboard. Your existing videos and settings will be preserved.