Name | youtube-bulk-upload JSON |
Version |
0.5.4
JSON |
| download |
home_page | None |
Summary | Upload all videos in a folder to youtube, e.g. to help re-populate an unfairly terminated channel |
upload_time | 2025-01-27 17:04:26 |
maintainer | None |
docs_url | None |
author | Andrew Beveridge |
requires_python | <3.13,>=3.9 |
license | MIT |
keywords |
|
VCS |
 |
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# YouTube Bulk Upload 🎥

**YouTube Bulk Upload** is a tool to facilitate the bulk uploading of video files to YouTube. This can be particularly useful for repopulating a channel after it has been unfairly terminated or when migrating content. The tool offers both a Command Line Interface (CLI) and a Graphical User Interface (GUI) to cater to different user preferences.
<img src="images/logo-nopadding.png" alt="YouTube Bulk Upload Logo" height="100">
## Features
- Bulk upload videos to YouTube from a specified directory.
- Customize video metadata, including titles, descriptions, and keywords.
- Dry run mode to preview actions without making changes.
- Non-interactive mode for automated processes.
- Support for thumbnail customization.
## Installation (GUI)
YouTube Bulk Upload provides a Graphical User Interface (GUI) that can be launched from a stand-alone executable.
The GUI allows you to configure all the options available and use the tool through a (somewhat) user-friendly interface.
Download the executable (`.exe` or `.dmg`) for your operating system from the [Releases page](https://github.com/beveradb/youtube-bulk-upload/releases).
### Mac
Double-click the `.dmg` file to run the installer. Install the application by dragging the icon to your Applications folder:
<img src="images/YouTubeBulkUpload-v0.3.4-Mac-GUI-Installer.png" alt="YouTube Bulk Upload GUI Example" height="300">
Then run the application from your Applications folder as normal, it should look something like this:

### Windows
Double-click the `.exe` file to run the application - it doesn't need to be installed first.
Once it loads, it should look something like this:

## Creating a Client Secret for the YouTube Data API
To use this tool, you'll need an OAuth 2.0 Client Secret (JSON file) with scopes enabled for the YouTube Data API.
This authenticates the app with Google's servers and allows you to interact with your own channel via the YouTube API.
YouTube provide [these instructions](https://developers.google.com/youtube/registering_an_application) for how to do this, but those instructions aren't very detailed.
### Video Demonstration
Here's a screencast video demonstration of the instructions below:
[](https://www.youtube.com/watch?v=3Sor3kw3LX8)
### Step-by-step Instructions
1) Log into the [Google Cloud Console](https://console.cloud.google.com) with your own Google Account. If you've never used GCP before, you'll probably need to click accept or something to enable it.
2) Create a [Google Cloud project](https://console.cloud.google.com/projectcreate), if you don't already have one.
3) Enable the [YouTube Data API](https://console.cloud.google.com/apis/library/youtube.googleapis.com). <img src="images/GCPEnableYouTubeDataAPI.png" alt="Enabling API client credential scopes" height="300">
4) Configure the [OAuth Consent Screen](https://console.cloud.google.com/apis/credentials/consent/edit) with minimal details for "your app" such as name (e.g. "My YouTube Bulk Uploader") and your email address for both the "user support" and "developer contact", then click `Save and Continue`. <img src="images/GCPOAuthConsentScreenBasics.png" alt="GCP OAuth Consent Screen Basic Configuration" height="300">
5) On the Scopes tab, click `Add or Remove Scopes`, select the "Manage your YouTube account" scope (`.../auth/youtube`) and click Update, then `Save and Continue`. <img src="images/GCPOAuthScopesYouTubeData.png" alt="GCP OAuth Consent Screen Scopes" height="300">
6) On the `Test users`, add your own google account email address as a test user, then click `Save and Continue`. On the final confirmation screen, just click `Back to Dashboard`. <img src="images/GCPOAuthConsentScreenTestUsers.png" alt="GCP OAuth Consent Screen Test Users" height="300">
7) From the [API Credentials](https://console.cloud.google.com/apis/credentials) page, click `Create Credentials` then `OAuth client ID`. Set the application type to `Desktop app` and give it a name, e.g. `My YouTube Bulk Uploader` <img src="images/GCPCreateOAuthClientID.png" alt="Creating OAuth client ID" height="300">
8) Once you see the `OAuth client created` screen, click `Download JSON` - this is the file you should specify in the "Client Secret File" setting in the YouTube Bulk Upload GUI/CLI. <img src="images/GCPOAuthClientCreated.png" alt="Downloading OAuth client secret credentials JSON" height="300">
## Usage (GUI))
👀 [Watch this tutorial video](https://youtu.be/9WklrdupZhg) for a better explanation and demonstration of how to use this tool.
YouTube Bulk Upload helps you upload videos to YouTube in bulk from a single folder, with custom metadata derived from the video file names.
Once you have a YouTube API client secret, you can point this tool at a directory of video files and it will upload them to YouTube, generating titles based on the filename, setting descriptions based on a template file, and optionally using a dedicated thumbnail image for each video in the same directory.
I highly recommend testing it out with "Dry Run" enabled first, in which mode it will log exactly what it is doing but won't actually upload anything.
Once you have confidence that your settings are correct and you're ready to execute it in bulk on a large number of files, tick the "Non-interactive" checkbox and it will no longer prompt you with popups asking for confirmation.
The find/replace patterns for video titles, thumbnail filenames, and YouTube descriptions all support regular expressions and empty replacement strings, or they can be left blank if you don't need to use them.
Hover over any element in the user interface for a tooltip popup explanation of that functionality.
## Installation (CLI)
To install YouTube Bulk Upload, ensure you have Python 3.9 or newer installed on your system. You can then install the tool using pip:
```bash
pip install youtube-bulk-upload
```
This command installs the latest version of YouTube Bulk Upload along with its dependencies.
## Usage (CLI)
The CLI offers a straightforward way to use YouTube Bulk Upload from your terminal or command prompt.
**Basic Usage**
To start a bulk upload with the default settings, navigate to the directory containing your video files and run:
```bash
youtube-bulk-upload
```
Refer to the CLI help for more options:
```bash
youtube-bulk-upload --help
```
## Integrating as a Package
You can also use YouTube Bulk Upload as a package in your own Python code. Here's a basic example of how to use it:
```bash
from youtube_bulk_upload.bulk_upload import YouTubeBulkUpload
uploader = YouTubeBulkUpload(
source_directory="/path/to/videos",
youtube_client_secrets_file="/path/to/client_secret.json",
dry_run=True # Set to False to perform actual uploads
)
uploaded_videos = uploader.process()
```
This script initializes the uploader with a source directory and a client secrets file, then starts the upload process in dry run mode.
All of the parameters available in the CLI (`youtube-bulk-upload --help`) are available in the `YouTubeBulkUpload` class.
For details, see the code in `youtube_bulk_upload/bulk_upload.py`.
For an example, see the CLI usage in `youtube_bulk_upload/cli.py`.
## License
YouTube Bulk Upload is released under the MIT License. See the LICENSE file for more details.
## Contributing
Contributions are welcome! Please feel free to submit pull requests or open issues on the GitHub repository.
## Acknowledgments
This project is maintained by Andrew Beveridge <andrew@beveridge.uk>.
Special thanks to all contributors and users for their support and feedback.
Raw data
{
"_id": null,
"home_page": null,
"name": "youtube-bulk-upload",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Andrew Beveridge",
"author_email": "andrew@beveridge.uk",
"download_url": "https://files.pythonhosted.org/packages/7b/a8/0f5ccd41c96f08daae4b14d2860b7692eb4d603cd5ef449368ee968dd89a/youtube_bulk_upload-0.5.4.tar.gz",
"platform": null,
"description": "# YouTube Bulk Upload \ud83c\udfa5\n\n\n\n**YouTube Bulk Upload** is a tool to facilitate the bulk uploading of video files to YouTube. This can be particularly useful for repopulating a channel after it has been unfairly terminated or when migrating content. The tool offers both a Command Line Interface (CLI) and a Graphical User Interface (GUI) to cater to different user preferences.\n\n<img src=\"images/logo-nopadding.png\" alt=\"YouTube Bulk Upload Logo\" height=\"100\">\n\n## Features\n- Bulk upload videos to YouTube from a specified directory.\n- Customize video metadata, including titles, descriptions, and keywords.\n- Dry run mode to preview actions without making changes.\n- Non-interactive mode for automated processes.\n- Support for thumbnail customization.\n\n## Installation (GUI)\n\nYouTube Bulk Upload provides a Graphical User Interface (GUI) that can be launched from a stand-alone executable.\n\nThe GUI allows you to configure all the options available and use the tool through a (somewhat) user-friendly interface.\n\nDownload the executable (`.exe` or `.dmg`) for your operating system from the [Releases page](https://github.com/beveradb/youtube-bulk-upload/releases).\n\n### Mac\n\nDouble-click the `.dmg` file to run the installer. Install the application by dragging the icon to your Applications folder:\n\n<img src=\"images/YouTubeBulkUpload-v0.3.4-Mac-GUI-Installer.png\" alt=\"YouTube Bulk Upload GUI Example\" height=\"300\">\n\nThen run the application from your Applications folder as normal, it should look something like this:\n\n\n\n### Windows\n\nDouble-click the `.exe` file to run the application - it doesn't need to be installed first.\n\nOnce it loads, it should look something like this:\n\n\n\n## Creating a Client Secret for the YouTube Data API \n\nTo use this tool, you'll need an OAuth 2.0 Client Secret (JSON file) with scopes enabled for the YouTube Data API.\nThis authenticates the app with Google's servers and allows you to interact with your own channel via the YouTube API.\n\nYouTube provide [these instructions](https://developers.google.com/youtube/registering_an_application) for how to do this, but those instructions aren't very detailed.\n\n### Video Demonstration\n\nHere's a screencast video demonstration of the instructions below:\n\n[](https://www.youtube.com/watch?v=3Sor3kw3LX8)\n\n### Step-by-step Instructions\n\n1) Log into the [Google Cloud Console](https://console.cloud.google.com) with your own Google Account. If you've never used GCP before, you'll probably need to click accept or something to enable it.\n\n2) Create a [Google Cloud project](https://console.cloud.google.com/projectcreate), if you don't already have one.\n\n3) Enable the [YouTube Data API](https://console.cloud.google.com/apis/library/youtube.googleapis.com). <img src=\"images/GCPEnableYouTubeDataAPI.png\" alt=\"Enabling API client credential scopes\" height=\"300\">\n\n4) Configure the [OAuth Consent Screen](https://console.cloud.google.com/apis/credentials/consent/edit) with minimal details for \"your app\" such as name (e.g. \"My YouTube Bulk Uploader\") and your email address for both the \"user support\" and \"developer contact\", then click `Save and Continue`. <img src=\"images/GCPOAuthConsentScreenBasics.png\" alt=\"GCP OAuth Consent Screen Basic Configuration\" height=\"300\">\n\n5) On the Scopes tab, click `Add or Remove Scopes`, select the \"Manage your YouTube account\" scope (`.../auth/youtube`) and click Update, then `Save and Continue`. <img src=\"images/GCPOAuthScopesYouTubeData.png\" alt=\"GCP OAuth Consent Screen Scopes\" height=\"300\">\n\n6) On the `Test users`, add your own google account email address as a test user, then click `Save and Continue`. On the final confirmation screen, just click `Back to Dashboard`. <img src=\"images/GCPOAuthConsentScreenTestUsers.png\" alt=\"GCP OAuth Consent Screen Test Users\" height=\"300\">\n\n7) From the [API Credentials](https://console.cloud.google.com/apis/credentials) page, click `Create Credentials` then `OAuth client ID`. Set the application type to `Desktop app` and give it a name, e.g. `My YouTube Bulk Uploader` <img src=\"images/GCPCreateOAuthClientID.png\" alt=\"Creating OAuth client ID\" height=\"300\">\n\n8) Once you see the `OAuth client created` screen, click `Download JSON` - this is the file you should specify in the \"Client Secret File\" setting in the YouTube Bulk Upload GUI/CLI. <img src=\"images/GCPOAuthClientCreated.png\" alt=\"Downloading OAuth client secret credentials JSON\" height=\"300\">\n\n\n## Usage (GUI))\n\n\ud83d\udc40 [Watch this tutorial video](https://youtu.be/9WklrdupZhg) for a better explanation and demonstration of how to use this tool.\n\nYouTube Bulk Upload helps you upload videos to YouTube in bulk from a single folder, with custom metadata derived from the video file names.\n\nOnce you have a YouTube API client secret, you can point this tool at a directory of video files and it will upload them to YouTube, generating titles based on the filename, setting descriptions based on a template file, and optionally using a dedicated thumbnail image for each video in the same directory.\n\nI highly recommend testing it out with \"Dry Run\" enabled first, in which mode it will log exactly what it is doing but won't actually upload anything.\n\nOnce you have confidence that your settings are correct and you're ready to execute it in bulk on a large number of files, tick the \"Non-interactive\" checkbox and it will no longer prompt you with popups asking for confirmation.\n\nThe find/replace patterns for video titles, thumbnail filenames, and YouTube descriptions all support regular expressions and empty replacement strings, or they can be left blank if you don't need to use them.\n\nHover over any element in the user interface for a tooltip popup explanation of that functionality.\n\n\n## Installation (CLI)\n\nTo install YouTube Bulk Upload, ensure you have Python 3.9 or newer installed on your system. You can then install the tool using pip:\n\n```bash\npip install youtube-bulk-upload\n```\n\nThis command installs the latest version of YouTube Bulk Upload along with its dependencies.\n\n## Usage (CLI)\nThe CLI offers a straightforward way to use YouTube Bulk Upload from your terminal or command prompt.\n\n**Basic Usage**\nTo start a bulk upload with the default settings, navigate to the directory containing your video files and run:\n\n```bash\nyoutube-bulk-upload\n```\n\nRefer to the CLI help for more options:\n\n```bash\nyoutube-bulk-upload --help\n```\n\n## Integrating as a Package\n\nYou can also use YouTube Bulk Upload as a package in your own Python code. Here's a basic example of how to use it:\n\n```bash\nfrom youtube_bulk_upload.bulk_upload import YouTubeBulkUpload\n\nuploader = YouTubeBulkUpload(\n source_directory=\"/path/to/videos\",\n youtube_client_secrets_file=\"/path/to/client_secret.json\",\n dry_run=True # Set to False to perform actual uploads\n)\n\nuploaded_videos = uploader.process()\n```\n\nThis script initializes the uploader with a source directory and a client secrets file, then starts the upload process in dry run mode.\n\nAll of the parameters available in the CLI (`youtube-bulk-upload --help`) are available in the `YouTubeBulkUpload` class.\n\nFor details, see the code in `youtube_bulk_upload/bulk_upload.py`.\nFor an example, see the CLI usage in `youtube_bulk_upload/cli.py`.\n\n## License\nYouTube Bulk Upload is released under the MIT License. See the LICENSE file for more details.\n\n## Contributing\nContributions are welcome! Please feel free to submit pull requests or open issues on the GitHub repository.\n\n## Acknowledgments\nThis project is maintained by Andrew Beveridge <andrew@beveridge.uk>.\nSpecial thanks to all contributors and users for their support and feedback.\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Upload all videos in a folder to youtube, e.g. to help re-populate an unfairly terminated channel",
"version": "0.5.4",
"project_urls": {
"Documentation": "https://github.com/beveradb/youtube-bulk-upload/blob/main/README.md",
"Homepage": "https://github.com/beveradb/youtube-bulk-upload",
"Repository": "https://github.com/beveradb/youtube-bulk-upload"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fae826da22e2c3c0201b81efcbe3808767ce394fde6ac285c6dd8cdcd707e6da",
"md5": "0416b8d989d5fc15479b9c288335e536",
"sha256": "762870e5e299e237375d87e1a71d0d260cbd0c0a0fe5648b27928055c44dd52b"
},
"downloads": -1,
"filename": "youtube_bulk_upload-0.5.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0416b8d989d5fc15479b9c288335e536",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 262372,
"upload_time": "2025-01-27T17:04:25",
"upload_time_iso_8601": "2025-01-27T17:04:25.181143Z",
"url": "https://files.pythonhosted.org/packages/fa/e8/26da22e2c3c0201b81efcbe3808767ce394fde6ac285c6dd8cdcd707e6da/youtube_bulk_upload-0.5.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7ba80f5ccd41c96f08daae4b14d2860b7692eb4d603cd5ef449368ee968dd89a",
"md5": "b360edfa04b56879b9a76ef84526b19b",
"sha256": "b558c52aa4b1fb3598e736606eeb5cae83a5cfb2ee9393112ad58963df29f795"
},
"downloads": -1,
"filename": "youtube_bulk_upload-0.5.4.tar.gz",
"has_sig": false,
"md5_digest": "b360edfa04b56879b9a76ef84526b19b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 263149,
"upload_time": "2025-01-27T17:04:26",
"upload_time_iso_8601": "2025-01-27T17:04:26.657385Z",
"url": "https://files.pythonhosted.org/packages/7b/a8/0f5ccd41c96f08daae4b14d2860b7692eb4d603cd5ef449368ee968dd89a/youtube_bulk_upload-0.5.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-27 17:04:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "beveradb",
"github_project": "youtube-bulk-upload",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "youtube-bulk-upload"
}