Uploading to YouTube¶
This workflow guide covers the complete process of uploading your recordings to YouTube, from initial setup to published video.
Workflow Overview¶
graph TD
A[First Time?] -->|Yes| B[Options]
A -->|No| E
B -->|Configure| C[YouTube Setup]
C -->|Authenticate| D[Google OAuth]
D -->|Success| E[Select Video]
E -->|From Processing| F[YouTube Upload]
E -->|From History| F
F -->|Configure| G[Set Metadata]
G -->|Upload| H[Progress]
H -->|Complete| I[View on YouTube]
First-Time Setup¶
If you haven't connected YouTube yet, you'll need to set up API credentials first.
- Go to Google Cloud Console
- Create a new project or select existing
- Enable YouTube Data API v3
- Go to APIs & Services → Credentials
- Click Create Credentials → OAuth 2.0 Client ID
- Select Desktop Application
- Copy the Client ID and Client Secret
- Open Main Menu → Options
- Select Configure YouTube
- Enter your Client ID and Client Secret
- Press Connect
- A browser window opens automatically
- Sign in to your Google account
- Grant permissions to the application
- Return to the terminal
Setup Complete
Once authenticated, you won't need to repeat this process unless you disconnect or revoke access.
Uploading a Video¶
From Processing Screen¶
After completing a recording:
When processing completes, choose Upload to YouTube from the options.
From Recording History¶
For existing recordings:
- Go to Main Menu → Recording History
- Navigate to the recording you want to upload
- Press u to upload
Configure Upload¶
The title is pre-filled from your recording. Edit if needed.
Tip: Include keywords for better discoverability.
Add or modify the video description. Include:
- Brief summary of content
- Timestamps for sections
- Links to resources
- Call to action
Choose visibility:
| Public | Anyone can find and watch |
| Unlisted | Only via direct link (recommended for review) |
| Private | Only you can watch |
Optionally add the video to a playlist for organization.
Upload Process¶
Press Upload to begin. The progress screen shows:
- Upload percentage
- Bytes transferred
- Current speed
- Estimated time remaining
Don't Close
Keep the application open during upload. Closing will cancel the upload.
Upload time depends on:
- File size
- Internet connection speed
- YouTube server load
After Upload¶
- Copy the video URL provided
- Select Open in Browser to view immediately
- Or press Done to return to the application
Processing Time
YouTube may take additional time to process your video after upload. Higher resolutions (1080p, 4K) take longer to become available.
Managing Playlists¶
Creating a New Playlist¶
Go to Options → Configure YouTube
- Scroll to the Playlists section
- Select Create Playlist
- Enter title and description
- Set privacy level
- Press Create
Setting Default Playlist¶
In YouTube Setup, you can set a default playlist that's automatically selected for new uploads.
Best Practices¶
Video Titles¶
| Do | Don't |
|---|---|
| Be descriptive and specific | Use clickbait |
| Include keywords naturally | Stuff keywords |
| Keep under 60 characters | Write novels |
Descriptions¶
In this video, I'll show you how to [main topic].
Timestamps:
0:00 Introduction
1:30 Setting up
3:45 Main demonstration
8:20 Tips and tricks
10:00 Conclusion
Resources:
- Link to project: https://...
- Documentation: https://...
Subscribe for more tutorials!
Privacy Strategy¶
- Upload as Unlisted first
- Review on YouTube for issues
- Add thumbnail, cards, end screens
- Change to Public when ready
Troubleshooting¶
Authentication Expired¶
Symptom: "Auth expired" error when trying to upload
Solution: 1. Go to Options → Configure YouTube 2. Select "Disconnect" 3. Reconnect and re-authenticate
Upload Stuck at 0%¶
Symptom: Progress bar doesn't move
Possible causes: - Firewall blocking connection - Network issues - YouTube API quota exceeded
Solution: 1. Check internet connection 2. Try again later 3. Check Google Cloud Console for quota status
Video Processing Failed on YouTube¶
Symptom: Upload succeeds but video shows error on YouTube
Possible causes: - Corrupt video file - Unsupported codec
Solution: 1. Re-export video with standard settings 2. Use H.264 codec, AAC audio 3. Try re-uploading
Quick Reference¶
Keyboard Shortcuts (Upload Screen)¶
| Key | Action |
|---|---|
| Tab | Next field |
| Shift+Tab | Previous field |
| Left / Right | Change selection |
| Enter | Upload |
| Esc | Cancel |
Upload Requirements¶
| Requirement | Specification |
|---|---|
| Format | MP4 (H.264/AAC) |
| Max Size | 256 GB |
| Max Duration | 12 hours |
| Resolution | Up to 8K |
Related Pages¶
- YouTube Setup - Configure credentials
- YouTube Upload - Upload screen details
- Recording Workflow - Create recordings first
- History - Upload past recordings