youtubeuploader for Mac
Scripted uploads to youtube. upload video files from local disk or from the web. ratelimit upload bandwidth
youtubeuploader — overview
Youtube Uploader
Scripted uploads to youtube. upload video files from local disk or from the web. ratelimit upload bandwidth
Download
Grab a precompiled binary for Linux, Mac or Windows or build it yourself.
Setup
Youtube API
Talking to the Youtube API requires oauth2 authentication. As such, you must: Create an account on the Google Developers Console Create a new project for this app Enable the Youtube API (APIs & Services -> Enable APIs and Services -> Click 'ENABLE APIS AND SERVICES' top right). Select 'YouTube Data API v3' Create OAuth consent screen (APIs & Services -> OAuth Consent Screen) Add a test user in "Audience -> Test users". This can be any Google User account but it should correspond with the Youtube account where videos will be uploaded. Create Credentials (APIs & Services -> Credentials -> click 'CREATE CREDENTIALS'), select 'OAuth client ID', select 'Web application' Add an 'Authorized redirect URI' of 'http://localhost:8080/oauth2callback' Download the client secrets JSON file (click download icon next to newly created client ID) and save it as file client_secrets.json in the same directory as the utility e.g.
NOTE 1 Google will apply 'private' status on videos uploaded to newly created projects - from Google's Announcement: All videos uploaded via the videos.insert endpoint from unverified API projects created after 28 July 2020 will be restricted to private viewing mode. To lift this restriction, each project must undergo an audit to verify compliance with the Terms of Service.
See Issue #86 for more information.
NOTE 2 By default you will only be able to upload ~6 videos every 24 hours due to quota restrictions set by Google. See Issue #119 for more information.
Usage
At a minimum, just specify a filename:
If it is the first time you've run the utility, a browser window should popup and prompt you to provide Youtube credentials. A token will be created and stored in request.token file in the local directory for subsequent use. To run the utility on a headless-server, generate the token file locally first, then simply copy the token file along with youtubeuploader and client_secrets.json to the remote host.
Full list of options:
NOTE: When specifying a URL as the filename, the data will be streamed through the localhost (download from remote host, then upload to Youtube)
If -quiet is specified, no upload progress will be displayed. Current progress can be output by sending signal USR1 to the process e.g. kill -USR1 (Linux/Unix only).
Metadata
Video title, description etc can specified via the command line flags or via a JSON file using the -metaJSON flag. An example JSON file would be: all fields are optional use n in the description to insert newlines times can be provided in one of two formats: yyyy-mm-dd (UTC) or yyyy-mm-ddThh:mm:ss+zz:zz any values supplied via -metaJSON will take precedence over flags
Credit
Based on Go Youtube API Sample code
Details
脚本化上传到YouTube
How to install youtubeuploader
- Open Terminal (press ⌘ + Space and type “Terminal”).
- If Homebrew is not installed yet, run the command below first.
- Run this command:
Latest 10 releases
Last updated 2025-08-14; current version v1.25.5, with the latest 9 releases listed.
| Version | Released | Type | Size | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v1.25.5 | 2025-08-14 | Stable | 10.5 MB | Download | Download | Download |
| v1.25.4 | 2025-08-12 | Stable | 10.5 MB | Download | Download | Download |
| v1.25.3 | 2025-07-18 | Stable | 10.5 MB | Download | Download | Download |
| v1.25.2 | 2025-07-14 | Stable | 10.5 MB | Download | Download | Download |
| v1.25.1 | 2025-06-25 | Stable | 10.5 MB | Download | Download | Download |
| v1.24.4 | 2024-12-01 | Stable | 9.8 MB | Download | Download | Download |
| 24.03 | 2024-11-20 | Stable | 9.8 MB | Download | Download | Download |
| 24.02 | 2024-10-05 | Stable | 9.4 MB | Download | Download | Download |
| 24.01 | 2024-06-30 | Stable | 9.4 MB | Download | Download | Download |
Data from GitHub Releases; stable releases first, each group sorted newest first.
Prebuilt bottle platforms
Official Homebrew bottles cover:
- Apple silicon · latest macOS
- Apple silicon · macOS 26 Tahoe
- Apple silicon · macOS 15 Sequoia
- Apple silicon · macOS 14 Sonoma
- Apple silicon · macOS 13 Ventura
- Intel · macOS 14 Sonoma
- Intel · macOS 13 Ventura
- Linux · ARM64
- Linux · x86_64
Compared with similar apps
Only public metadata is compared, with no subjective recommendation; see the compare pages for field-by-field comparisons.
| App | Version | License | Architecture | 30-day installs |
|---|---|---|---|---|
| youtubeuploader | v1.25.5 | Apache-2.0 | CLI | 13 |
| gpsbabel | Continuous-Windows | GPL-2.0-or-later | CLI | 26 |
| isponsorblocktv | v2.11.0 | GPL-3.0-only | CLI | 14 |
| yutu | v0.11.0 | Apache-2.0 | CLI | 36 |
Similar apps: Command-line Tools
gpsbabel
Converts/uploads GPS waypoints, tracks, and routesisponsorblocktv
iSponsorBlockTV is a self-hosted application that connects to your YouTube for TV app (see…yutu
CLI, MCP server, and AI agent to automate YouTube workflowsopenssl@4
Cryptography and SSL/TLS Toolkitxz
General-purpose data compression with high compression ratiopkgconf
pkgconf is a program which helps to configure compiler and linker flags for development…Categories: Command-line Tools