youtube-bulk-upload 0.3.6

Upload all videos in a folder to youtube, e.g. to help re-populate an unfairly terminated channel

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.

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.

Mac

Double-click the .dmg file to run the installer. Install the application by dragging the icon to your Applications folder:

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:

Usage (GUI))

👀 Watch this tutorial video 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.

To use it, you'll need a YouTube Data API Client Secret (JSON file) - reach out to Andrew if you aren't sure where to get this!

Once you have that, 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:

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:

youtube-bulk-upload

Refer to the CLI help for more options:

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:

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. Special thanks to all contributors and users for their support and feedback.