YouTube Integration

Connect your YouTube account to sync playlists, track subscriptions, and organize all your video content in one place.

Overview

Corixa's YouTube integration lets you sync your entire YouTube library using just your free Google account - no YouTube Premium or paid subscription required.

With YouTube sync, you can:

  • Sync Playlists - Automatically import videos from your YouTube playlists
  • Track Subscriptions - Keep a local record of channels you subscribe to
  • Auto-Create Categories - Each playlist becomes a Corixa category
  • Rich Metadata - Full video details including duration, thumbnails, and descriptions
  • Offline Access - Browse your video library without an internet connection
Corixa showing YouTube subscription videos with thumbnails, titles, and channel information

Requirements

Before you can sync YouTube content, you'll need:

  • A Free Google Account - The same account you use for YouTube, Gmail, or other Google services
  • YouTube Content - At least one playlist or subscription on your YouTube account
  • Internet Connection - Required during sign-in and sync (not needed to browse already-synced content)
No Premium Required
YouTube sync works with any free Google account. You don't need YouTube Premium, a paid subscription, or any special membership - just a regular Google account that you use to watch YouTube.

Connecting Your YouTube Account

To use YouTube features, connect your Google account by following these steps:

Open YouTube Settings

Go to Corixa > Settings > YouTube, or click the YouTube icon in the toolbar.

Click "Connect YouTube Account"

Your default web browser will open to Google's sign-in page.

Sign In with Your Google Account

Enter your email address and password on the Google sign-in page. This is the same login you use for Gmail, YouTube, or Google Drive. If you're already signed in, you may see your accounts listed - select the one with your YouTube content.

Review and Allow Permissions

Google will show you what Corixa is requesting access to. You'll see permissions for viewing your YouTube playlists and subscriptions. Click "Allow" or "Continue" to grant access.

Return to Corixa

After you allow access, the browser will show a success message and you can close it. Corixa will automatically detect the connection. Your Google account name will appear in YouTube Settings, confirming you're connected.

Screenshot: YouTube Settings (Before Connection)
Capture the YouTube settings panel showing the "Connect YouTube Account" button before a user has connected their account.
youtube-settings-disconnected.png
Screenshot: YouTube Settings (Connected)
Capture the YouTube settings panel after successful connection, showing the connected Google account name/email and the "Disconnect" option.
youtube-settings-connected.png
🔒 Privacy & Security
Corixa uses Google's secure sign-in. Your Google password is never stored or seen by Corixa - you sign in directly with Google. You can revoke access at any time from your Google Account settings.

Permissions Explained

When you connect YouTube, Corixa requests the following permissions:

Permission Purpose
View your YouTube playlists Required to fetch your playlists and their videos
View your YouTube subscriptions Required to sync your channel subscriptions

Corixa only has read access to your YouTube data. It cannot:

  • Modify or delete your playlists
  • Post comments or likes
  • Access your watch history
  • Access private videos you don't own

Syncing Playlists

Once connected, you can sync your YouTube playlists to Corixa.

Initial Sync

Go to YouTube Settings

Navigate to Settings > YouTube.

Select Playlists to Sync

You'll see a list of all your YouTube playlists. Check the boxes next to the playlists you want to sync.

Start Sync

Click Sync Now to begin importing videos. Progress will be shown in the status area.

Screenshot: Playlist Selection
Capture the YouTube settings panel showing the list of available playlists with checkboxes. Show some playlists checked and others unchecked, with playlist names and video counts visible.
playlist-selection.png

What Gets Synced

For each video in your selected playlists, Corixa imports:

  • Title - Video title
  • Thumbnail - High-quality video thumbnail
  • Duration - Video length
  • Channel - Channel name and link
  • Description - Full video description
  • Publish Date - When the video was uploaded
  • URL - Direct link to the video

Automatic Category Creation

When you sync a playlist, Corixa automatically:

  1. Creates a new category with the playlist name
  2. Assigns an appropriate icon and color
  3. Places all videos from that playlist into the category
Screenshot: Auto-Created Playlist Category
Capture the sidebar showing categories that were automatically created from YouTube playlists. Categories should have YouTube-related icons and show video counts.
youtube-auto-categories.png

Sync Settings

Customize how YouTube sync behaves in Settings.

Auto-Sync

Enable automatic syncing to keep your Corixa library up to date with YouTube changes.

  • On App Launch - Sync when Corixa starts
  • Periodic Sync - Sync every few hours in the background
  • Manual Only - Only sync when you click "Sync Now"

Sync Behavior

  • New Videos Only - Only import videos added since last sync
  • Update Metadata - Refresh titles, thumbnails, and descriptions for existing videos
  • Remove Deleted - Remove videos that are no longer in the playlist
Screenshot: YouTube Sync Settings
Capture the YouTube settings section showing sync options: auto-sync toggle, sync frequency, and behavior options.
youtube-sync-progress.png

Subscription Tracking

In addition to playlists, Corixa can sync your YouTube channel subscriptions.

Syncing Subscriptions

  1. Go to Settings > YouTube
  2. Enable Sync Subscriptions
  3. Click Sync Now

Corixa will import information about channels you subscribe to, including:

  • Channel name and thumbnail
  • Channel description
  • Subscriber count
  • Direct link to the channel
Screenshot: Synced Subscriptions
Capture Corixa showing synced YouTube subscriptions/channels with channel thumbnails, names, and subscriber counts in a list or grid view.
subscriptions-view.png

Managing YouTube Content

Viewing Video Details

Click any YouTube video to see full details in the detail panel:

  • Large thumbnail
  • Full description
  • Channel information
  • Duration and publish date
  • Quick actions (open in YouTube, copy link)
Screenshot: YouTube Video Detail Panel
Capture the detail panel for a YouTube video showing: large thumbnail, title, channel name with link, duration badge, description, publish date, and action buttons.
youtube-video-detail.png

Opening Videos

There are several ways to watch a video:

  • Double-click the video item to open in your default browser
  • Click the Play button in the detail panel
  • Right-click and select Open in YouTube
  • Use the keyboard shortcut Cmd + O

Reorganizing Videos

YouTube videos can be moved to different categories just like any other item:

  • Drag and drop to categories in the sidebar
  • Use the category dropdown in the detail panel
  • Right-click and select "Move to Category"
Organization Tip
You can reorganize synced videos into custom categories. Corixa will remember your organization even when new videos are synced from YouTube.

Duplicate Detection

Corixa intelligently handles duplicates when syncing YouTube content:

  • Same Video in Multiple Playlists - Only one copy is stored, but it can appear in multiple categories
  • Already Saved Videos - If you manually saved a video before syncing, Corixa recognizes it and updates the existing item
  • Fuzzy Matching - Similar videos (same title, channel) are detected to prevent near-duplicates

Disconnecting YouTube

To disconnect your YouTube account:

Open YouTube Settings

Go to Settings > YouTube.

Click "Disconnect"

Click the disconnect button next to your connected account.

Choose What to Keep

Decide whether to keep your synced videos and categories or remove them.

After Disconnecting
Your previously synced videos remain in Corixa even after disconnecting. They just won't receive updates. You can manually delete them or keep them for offline reference.

Troubleshooting

Common Issues

Sync Takes a Long Time

Large playlists with hundreds of videos may take several minutes to sync. Progress is shown in the status bar.

Some Videos Are Missing

Private videos, age-restricted content, or videos removed from YouTube won't appear in your sync.

Authentication Expired

If you see an authentication error, try disconnecting and reconnecting your YouTube account.

Playlists Not Appearing

Only playlists you own or have saved appear in the list. Shared playlist links need to be saved to your YouTube account first.

For more help, see the Troubleshooting Guide.

Next Steps

AI Features 📁 Categories