Skip to content

Processing

The Processing screen shows the progress of post-recording video processing. This is where your raw recordings are merged, enhanced, and finalized.

Screen Preview

Processing Video
━━━━━━━━━━━━━━━ Processing Video ━━━━━━━━━━━━━━━ ✓ Finalizing screen recording Done ✓ Processing audio Done ✓ Merging video and audio Done ◐ Adding logo overlays 47% ████████████████████░░░░░░░░░░░░░░░░░░░░ ○ Creating vertical version Pending ○ Saving metadata Pending ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Processing... Please wait

Processing Steps

The processing pipeline runs the following steps in order:

1. Finalizing Screen Recording

✓ Finalizing screen recording

Ensures the raw screen capture file is properly closed and finalized.

Actions:

  • Waits for FFmpeg to complete writing
  • Verifies file integrity
  • Checks container format

2. Processing Audio

✓ Processing audio

Normalizes and optimizes the audio track.

Actions:

  • Audio normalization (consistent volume)
  • Noise reduction (if enabled)
  • Format conversion to AAC

3. Merging Video and Audio

✓ Merging video and audio

Combines the separate video and audio streams into a single file.

Actions:

  • Synchronizes audio with video
  • Re-encodes to H.264/AAC
  • Applies basic quality settings

4. Adding Webcam Overlay

○ Adding webcam overlay (conditional)

Only runs if webcam recording was enabled.

Actions:

  • Positions webcam in corner
  • Scales webcam to appropriate size
  • Composites over main video

5. Adding Logo Overlays

◐ Adding logo overlays (conditional)

Only runs if logo overlays were enabled.

Actions:

  • Positions logos at configured corners
  • Handles animated GIFs (loop mode)
  • Adds title text overlay
  • Composites all layers

Logo Positions:

┌────────────────────────────────────┐
│ [Left Logo]            [Right Logo]│
│                                    │
│          Recording Content         │
│                                    │
│           [Bottom Logo]            │
└────────────────────────────────────┘

6. Creating Vertical Version

○ Creating vertical version (conditional)

Only runs if vertical video was enabled.

Actions:

  • Crops to 9:16 aspect ratio
  • Centers content
  • Creates separate _vertical.mp4 file

7. Saving Metadata

○ Saving metadata

Writes recording information to a JSON file.

Metadata includes:

  • Recording title and description
  • Duration and file sizes
  • Topic and episode number
  • Timestamps
  • Processing settings used

Step Status Icons

Icon Status Meaning
✓ Complete Step finished successfully
◐ Running Step currently in progress
○ Pending Step waiting to run
✗ Failed Step encountered an error
⊘ Skipped Step not needed for this recording

Progress Bar

For long-running steps, a progress bar shows completion percentage:

Progress Examples
0% ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 25% ██████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 50% ████████████████████░░░░░░░░░░░░░░░░░░░░ 75% ██████████████████████████████░░░░░░░░░░ 100% ████████████████████████████████████████

Processing Complete

When all steps finish successfully:

Processing Complete
━━━━━━━━━━━━━━━ Processing Complete ━━━━━━━━━━━━━ ✓ Finalizing screen recording Done ✓ Processing audio Done ✓ Merging video and audio Done ✓ Adding logo overlays Done ✓ Creating vertical version Done ✓ Saving metadata Done ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✓ All processing complete! [ Upload to YouTube ] [ Return to Menu ] ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ enter: select • q: quit

Options after completion:

Button Description
Upload to YouTube Navigate to YouTube Upload to share your recording
Return to Menu Go back to Main Menu

YouTube Button

The "Upload to YouTube" button only appears if YouTube is configured in Options. Use Left / Right or Tab to switch between buttons, then Enter to confirm.

Error Handling

If a step fails:

Processing Error
✓ Finalizing screen recording Done ✓ Processing audio Done ✗ Merging video and audio Failed Error: FFmpeg returned exit code 1 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✗ Processing failed [ Retry ] [ Return to Menu ]

Output Files

After successful processing:

~/Videos/Screencasts/<topic>/<title>/
├── final.mp4           # Main processed video
├── final_vertical.mp4  # Vertical version (if enabled)
├── metadata.json       # Recording information
├── video.mkv           # Raw screen capture (preserved)
├── audio.wav           # Raw audio (preserved)
└── webcam.mkv          # Raw webcam (if used)

Workflow Position

1
Previous: Recording → Stop recording
2
Current: Processing (this screen)
3

Technical Details

  • Encoding: H.264 video, AAC audio
  • Quality: CRF 23 (good quality, reasonable size)
  • Container: MP4 for maximum compatibility
  • Progress reporting: Via FFmpeg progress callback