Introduction

Python CLI YouTube Upload Utility

It's a fork of http://code.google.com/p/youtube-upload/ with some improvements

Youtube-upload is a command-line script that uploads videos to Youtube. Youtube-upload should work on any platform (GNU/Linux, BSD, OS X, Windows, ...) that runs Python.

Dependencies

• Python 2.6 or 2.7
• python-gdata (>= 1.2.4)

Note: You must have logged in at least once into your Youtube account prior to uploading any videos.

Download & Install

1. Download * Download latest ZIP https://github.com/TheMengzor/youtube-upload/archive/master.zip * Or clone git repo: git clone [email protected]:TheMengzor/youtube-upload.git
2. Install * Install it to the system: sudo python ./setup.py install * Or run it without an installation from youtube-upload folder: ./youtube-upload video.mov

Usage examples

Upload a video

youtube-upload [email protected] --password=mypassword \
               --title="A.S. Mutter" --description="A.S. Mutter plays Beethoven" \
               --category=Music --keywords="mutter, beethoven" anne_sophie_mutter.flv

Script will return vieo URL:

www.youtube.com/watch?v=pxzZ-fYjeYs

Upload a video with a description from file (description.txt)

youtube-upload [email protected] \
               --password=mypassword \
               --title="A.S. Mutter" \
               --description="$(< description.txt)" \
               --category=Music \
               --keywords="mutter, beethoven" \
               anne_sophie_mutter.flv

Script will return vieo URL:

www.youtube.com/watch?v=pxzZ-fYjeYs

Upload the video using the Youtube API

youtube-upload --api-upload [OTHER OPTIONS] file.flv

If you set explicitly the --api-upload options or pycurl does not installed, the original Youtube API will be used to upload the video file. This method is not recommended because it does not shows the nice progressbar.

Upload a splited video

youtube-upload [OPTIONS] --title="TITLE" video.part1.avi video.part2.avi

Script will return video URLs and automatically add part number to the video title:

www.youtube.com/watch?v=pxzZ-fYjeYs # title: TITLE [1/2]
www.youtube.com/watch?v=pxzZ-fYsdff # title: TITLE [2/2]

Add a video to a playlist

youtube-upload [OPTIONS] --add-to-playlist=http://gdata.youtube.com/feeds/api/playlists/7986C428284A40A1 http://www.youtube.com/watch?v=Zpqu97l3G1U

Note that the argument must be the video URL (not a local file) and the playlist is the URL of the feed (with no prefix "PL").

Get available categories

youtube-upload --get-categories

Script will return a space-separated list of available categories

Tech Education Animals People Travel Entertainment Howto Sports Autos Music News Games Nonprofit Comedy Film

Split a video with ffmpeg

If you feeling problems to upload large file you can split it with FFMPEG. You can use the Bash example script to split it before uploading:

bash examples/split_video_for_youtube.sh video.avi

Script will return

video.part1.avi
video.part2.avi
video.part3.avi

Upload videos with curl

The script uses pycurl by default (when available) to upload the video, but if you need to tweak the upload parameters take a look at the Bash script included with the sources <http://code.google.com/p/youtube-upload/source/browse/trunk/examples/upload_with_curl.sh examples/upload_with_curl.sh>. This command, for example, would upload somevideo.flv with a limit rate of 100KBytes:

$ youtube-upload --get-upload-form-info [OPTIONS] | bash examples/upload_with_curl.sh --limit-rate 100k

Upload a non-public (private/unlisted) video:

$ youtube-upload --private ...

$ youtube-upload --unlisted ...

Use a HTTP proxy

Set environment variables http_proxy and https_proxy:

export http_proxy=http://user:password@host:port
export https_proxy=http://user:password@host:port
youtube-upload ....

Caveats

Validate your credentials

Before you upload a video using the script, do it manually to make sure everything is ok (you have a valid user/password and an associated channel). See issue57 for more details.

Using two-step verification

If you are using two-step verification issue an application-specific password and use it in the script as if it was your real password. See issue111 for more details.

Feedback

Use the issues tracker instead to report bugs or suggest improvements.