youtubeuploader

You can specify video metadata (title, description, tags, etc.) using the -metaJSON flag. Values provided in the JSON file take precedence over command-line flags.

Key Details:

• All fields are optional.
• Use \n in the description for newlines.
• Time formats: yyyy-mm-dd (UTC) or yyyy-mm-ddThh:mm:ss+zz:zz.
• If a URL is provided as a filename, data is streamed through localhost (downloaded from remote, then uploaded to YouTube).

{
      "title": "my test title",
      "description": "my test description",
      "tags": [
            "test tag1",
            "test tag2"
      ],
      "privacyStatus": "private",
      "madeForKids": false,
      "embeddable": true,
      "license": "creativeCommon",
      "publicStatsViewable": true,
      "publishAt": "2017-06-01T12:05:00+02:00",
      "categoryId": "10",
      "recordingDate": "2017-05-21",
      "playlistIds": [
            "xxxxxxxxxxxxxxxxxx",
            "yyyyyyyyyyyyyyyyyy"
      ],
      "playlistTitles": [
            "my test playlist"
      ],
      "language": "fr",
      "localizations": {
            "en": {
                  "title": "My English Title",
                  "description": "My English description"
            },
            "it": {
                  "title": "Il mio titolo in italiano",
                  "description": "La mia descrizione in italiano"
            }
      },
      "containsSyntheticMedia": false
}

To use youtubeuploader, you must configure OAuth2 authentication via the Google Developers Console.

1. Create a project in the Google Developers Console.
2. Enable the YouTube Data API v3.
3. Configure an OAuth consent screen and add your YouTube account as a Test user.
4. Create Credentials using the OAuth client ID type and select Web application.
5. Set the Authorized redirect URI to http://localhost:8080/oauth2callback.
6. Download the client secrets JSON file and save it as client_secrets.json in the same directory as the youtubeuploader binary.

Important Limitations:

• Privacy: Videos uploaded from unverified API projects are restricted to private status by default.
• Quota: Google imposes a quota that typically limits uploads to approximately 6 videos every 24 hours.

{
  "web": {
    "client_id": "xxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com",
    "project_id": "youtubeuploader-yyyyy",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "xxxxxxxxxxxxxxxxxxxx",
    "redirect_uris": [
      "http://localhost:8080/oauth2callback"
    ]
  }
}

The Run function relies on a Config struct to define the upload behavior. While the full struct definition is in another file, the following fields are explicitly used in Run to control the process:

• Filename (string): The name of the video file. Use "-" to indicate uploading from a pipe. This field is mandatory.
• Thumbnail (string): Path to the thumbnail image file. If provided, it is uploaded after the video.
• Caption (string): Path to the caption file. If provided, it is uploaded after the video.
• Language (string): The language code used for captions.
• Quiet (bool): If true, progress reporting is suppressed.
• OAuthPort (int): The port used for the OAuth2 flow.
• Chunksize (int64): The size of chunks used for the media upload.
• NotifySubscribers (bool): Whether to notify subscribers of the new video.
• SendFileName (bool): If true and Filename is not "-", the filename is added to the request header as a Slug.
• MetaJSONOut (string): If provided, the resulting YouTube video metadata is written to this file path as JSON.

The following flags are available for controlling the upload process:

Usage:
  -cache string
        token cache file (default "request.token")
  -caption string
        caption filename. Can be a URL
  -categoryId string
        video category Id
  -chunksize int
        size (in bytes) of each upload chunk. A zero value will cause all data to be uploaded in a single request (default 16777216)
  -debug
        turn on verbose log output
  -description string
        video description (default "uploaded by youtubeuploader")
  -filename string
        video filename. Can be a URL. Read from stdin with '-'
  -language string
        video language (default "en")
  -limitBetween string
        only rate limit between these times e.g. 10:00-14:00 (local time zone)
  -metaJSON string
        JSON file containing title,description,tags etc (optional)
  -metaJSONout string
        filename to write uploaded video metadata into (optional)
  -notify
        notify channel subscribers of new video. Specify '-notify=false' to disable. (default true)
  -oAuthPort int
        TCP port to listen on when requesting an oAuth token (default 8080)
  -playlistID value
        playlistID to add the video to. Can be used multiple times
  -privacy string
        video privacy status (default "private")
  -quiet
        suppress progress indicator
  -ratelimit int
        rate limit upload in Kbps. No limit by default
  -recordingDate value
        recording date e.g. 2024-11-23
  -secrets string
        Client Secrets configuration (default "client_secrets.json")
  -sendFilename
        send original file name to YouTube (default true)
  -tags string
        comma separated list of video tags
  -thumbnail string
        thumbnail filename. Can be a URL
  -title string
        video title
  -version
        show version

The LoadVideoMeta function prepares the data required for a YouTube upload. It takes a Config object and returns two objects: a *VideoMeta (internal metadata) and a *youtube.Video (the actual object used by the Google YouTube API).

Behavior Logic:

1. JSON Priority: If config.MetaJSON is provided, it reads and unmarshals that file into VideoMeta. This metadata takes precedence for fields like Title, Description, Tags, CategoryId, and Localizations.
2. Config Fallback: If fields are not set in the JSON, the function falls back to the values provided in the Config struct.
3. YouTube API Mapping: It maps the metadata to the specific structure required by the google.golang.org/api/youtube/v3 package, including setting ForceSendFields for SelfDeclaredMadeForKids and ContainsSyntheticMedia to ensure explicit values are sent to YouTube.
4. Playlist Merging: It combines PlaylistIDs from both the Config and the VideoMeta JSON, sorts them, and removes duplicates.

videoMeta, youtubeVideo, err := youtubeuploader.LoadVideoMeta(config)