Troubleshooting

If Generate Metadata fails, the app shows: "Metadata generation failed (code: X). Check Technical Log for details."
What to do: Select the row in the table, open the Details panel on the right, and click Show technical log in the Activity section to see the log for that file. For full runner output, check the file last_run.log on disk in the pipeline reports folder (yt_pipeline/outputs/Reports/last_run.log relative to the app).
Ensure Python and the pipeline script (yt_pipeline/run_pipeline.py) and its dependencies are installed and available (e.g. PYTHON_PATH or conda yt-gpu if used).

If Connect YouTube fails:

• "OAuth credentials missing" — Click Open UserData (from the Settings menu → Developer mode dialog) and create google_oauth_client.json in that folder with your Client ID and Secret.
• Error 401 / invalid_client — Use an OAuth client type Desktop app (not Web application), copy Client ID and Secret fully, enable YouTube Data API v3, and configure the OAuth consent screen. See YouTube Connect & Upload and GOOGLE_OAUTH_SETUP.md if available.
  Use Test connection and Reconnect from the YouTube chip in the command bar (click the YouTube status) to verify credentials.

If a row shows "File missing on disk. Re-import or remove this row." (status Error in the Details Activity / technical log), the file was moved, renamed, or deleted. Remove that row from the table, then add the video again from its new location: use Add (Files or Folder) in the toolbar to open the Add Videos dialog and choose Add Files or Add Folder.

If upload fails, check the Activity section in the Details panel and Show technical log for the selected row. Use Retry upload (for selected failed items) to try again. For YouTube quota issues, wait and retry later. Ensure YouTube is connected (Connect YouTube in the toolbar or Settings) and credentials are valid.

On Windows, install the latest Visual C++ redistributable. On macOS, if the app is blocked, go to System Preferences → Security & Privacy and allow the app.