Skip to content

YouTube Upload

The YouTube Upload screen handles the video upload process to YouTube, including metadata configuration and progress tracking.

Screen Preview

YouTube Upload
━━━━━━━━━━━━━━━ Upload to YouTube ━━━━━━━━━━━━━━ Video: Vertical (9:16) Landscape (16:9) Title: ┌────────────────────────────────────────────────┐ │ Introduction to QGIS - Episode 42 │ └────────────────────────────────────────────────┘ Description: ┌────────────────────────────────────────────────┐ │ Learn how to use the sketcher tool in QGIS │ │ for creating quick sketches and annotations. │ │ │ │ Presented by Tim Sketcher │ └────────────────────────────────────────────────┘ Privacy: Unlisted ←/→ to change Playlist: QGIS Tutorials ←/→ to change File: ~/Videos/Screencasts/.../final.mp4 (245 MB) [ Upload ] [ Cancel ] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ tab: next field • enter: upload • esc: cancel

Upload Configuration

Account Selection

Account: Selection

When multiple YouTube accounts are configured, you can choose which account to upload to.

Feature Description
Multiple Accounts Upload to different YouTube channels
Last Used Defaults to the most recently used account
Per-Video Each video can be uploaded to a different account

Use Left / Right to change selection.

Single Account

If only one YouTube account is configured, this option is hidden and the available account is used automatically.

Video Source

Video: Selection

When both vertical (9:16) and landscape (16:9) versions of your video exist, you can choose which one to upload:

Option Aspect Ratio Best For
Vertical (9:16) Portrait YouTube Shorts, mobile viewing
Landscape (16:9) Widescreen Standard YouTube videos, desktop viewing

Use Left / Right to change selection.

Single Format

If only one video format exists (vertical or landscape), this option is hidden and the available format is used automatically.

Title

Title: Text Input

The video title displayed on YouTube. Pre-filled from recording metadata.

Character Limit: 100 characters

Spell Check: The title is automatically checked for:

  • UK English spelling (US spellings are flagged with suggestions)
  • Common grammar issues (e.g., "a" vs "an")

Issues are shown below the input field with ⚠ warnings and suggested corrections.

Description

Description: Text Area

The video description. Pre-filled from recording metadata.

Spell Check: The description is automatically checked for:

  • UK English spelling (e.g., "colour" not "color")
  • Common grammar issues
  • Multiple consecutive spaces

Up to 3 issues are displayed; additional issues show as "... and X more issues".

Best Practices:

  • Include relevant keywords
  • Add timestamps for sections
  • Credit resources used
  • Include links to related content

Privacy

Privacy: Selection

Setting Icon Description
Public 🌐 Anyone can search and watch
Unlisted 🔗 Only accessible via direct link
Private 🔒 Only you can watch

Use Left / Right to change.

Playlist

Playlist: Selection

Select a playlist to add the video to. The video will be appended to the playlist after upload.

Options:

  • Your existing playlists
  • "(none)" - Don't add to a playlist

File Information

File: Display Only

Shows the video file path and size that will be uploaded.

Upload Progress

After pressing [ Upload ]:

Uploading
━━━━━━━━━━━━━━━ Uploading Video ━━━━━━━━━━━━━━━ Introduction to QGIS - Episode 42 Uploading... 67% ████████████████████████████░░░░░░░░░░░░░░ 164 MB / 245 MB Speed: 12.5 MB/s ETA: ~6 seconds ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Please wait... Do not close the application

Progress Information

Field Description
Percentage Upload completion (0-100%)
Progress Bar Visual progress indicator
Bytes Uploaded / Total bytes
Speed Current upload speed
ETA Estimated time remaining

Upload Complete

After successful upload:

Upload Complete
━━━━━━━━━━━━━━━ Upload Complete ━━━━━━━━━━━━━━━ ✓ Video uploaded successfully! Title: Introduction to QGIS - Episode 42 Privacy: Unlisted Playlist: QGIS Tutorials Video URL https://youtu.be/dQw4w9WgXcQ [ Open in Browser ] [ Done ] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ enter: select • q: done

Post-Upload Actions

Action Description
Open in Browser Opens the YouTube video page
Done Returns to previous screen

Error Handling

Upload Failed

Upload Error
✗ Upload Failed Error: Network connection lost The upload was interrupted. Your video was not published to YouTube. [ Retry ] [ Cancel ]

Common Errors:

Error Cause Solution
Network error Connection lost Check internet, retry
Auth expired Token expired Re-authenticate in Options
Quota exceeded API limit reached Wait 24 hours
Invalid video File corrupt Re-export video

Keyboard Shortcuts

Key Action
Tab Next field
Shift+Tab Previous field
Left / Right Change selection
Enter Upload / Select
Esc Cancel

Workflow Position

This screen is accessed from:

After upload:

  • Main Menu → Return to start
  • Browser → View video on YouTube

Technical Details

  • API: YouTube Data API v3
  • Upload Method: Resumable uploads
  • Chunk Size: 256 KB (for resume support)
  • Retry Logic: Automatic retry on transient failures