Scripting way to upload videos to peertube and youtube
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
LecygneNoir 2e600bc455 Fix bug with trailing / in peertube url. fix #6 5 years ago
lib Fix bug with trailing / in peertube url. fix #6 5 years ago
.gitignore Add option to disable comments on Peertube (Youtube has no option in API to do that) 6 years ago Add Changelog info for thumbnail feature 5 years ago
LICENSE initial commit 6 years ago Update README with new features and help for thumbnail 5 years ago
nfo_example.txt Merge branch 'feature/thumbnail' into develop 5 years ago
peertube_secret.sample Bugfix, no quotes are allowed inside peertube_secret 6 years ago Merge branch 'feature/thumbnail' into develop 5 years ago
youtube_secret.json.sample use youtube_secret instead of client_secret to allow more flexibility (possibility to use peertube_secret) 6 years ago


A scripting way to upload videos to peertube and youtube


Search in your package manager, otherwise use pip install --upgrade

  • google-auth
  • google-auth-oauthlib
  • google-auth-httplib2
  • google-api-python-client
  • docopt
  • schema
  • python-magic
  • requests-toolbelt
  • tzlocal

For Peertube and if you want to use the publishAt option, you also need some utilities on you local system


Edit peertube_secret and youtube_secret.json with your credentials.


Set your credentials, peertube server URL.
You can get client_id and client_secret by logging in your peertube website and reaching the URL: https://domain.example/api/v1/oauth-clients/local You can set OAUTHLIB_INSECURE_TRANSPORT to 1 if you do not use https (not recommended)


Youtube uses combination of oauth and API access to identify.

Credentials The first time you connect, prismedia will open your browser to as you to authenticate to Youtube and allow the app to use your Youtube channel.
It is here you choose which channel you will upload to.
Once authenticated, the token is stored inside the file .youtube_credentials.json.
Prismedia will try to use this file at each launch, and re-ask for authentication if it does not exist.

The default youtube_secret.json should allow you to upload some videos.
If you plan an larger usage, please consider creating your own youtube_secret file:

  • Go to the Google console.
  • Create project.
  • Side menu: APIs & auth -> APIs
  • Top menu: Enabled API(s): Enable all Youtube APIs.
  • Side menu: APIs & auth -> Credentials.
  • Create a Client ID: Add credentials -> OAuth 2.0 Client ID -> Other -> Name: prismedia1 -> Create -> OK
  • Download JSON: Under the section "OAuth 2.0 client IDs". Save the file to your local system.
  • Save this JSON as your youtube_secret.json file.

How To

Currently in heavy development

Support only mp4 for cross compatibility between Youtube and Peertube

Simply upload a video:

./ --file="yourvideo.mp4"

Specify description and tags:

./ --file="yourvideo.mp4" -d "My supa description" -t "tag1,tag2,foo"

Provide a thumbnail:

./ --file="yourvideo.mp4" -d "Video with thumbnail" --thumbnail="/path/to/your/thumbnail.jpg"

Use a NFO file to specify your video options:

./ --file="yourvideo.mp4" --nfo /path/to/your/nfo.txt

Use --help to get all available options:

prismedia_upload - tool to upload videos to Peertube and Youtube

Usage: --file=<FILE> [options] --file=<FILE> --tags=STRING [--mt options] -h | --help --version

  --name=NAME  Name of the video to upload. (default to video filename)
  -d, --description=STRING  Description of the video. (default: default description)
  -t, --tags=STRING  Tags for the video. comma separated.
                     WARN: tags with space and special characters (!, ', ", ?, ...)
                           are not supported by Mastodon to be published from Peertube
                           use mastodon compatibility below
  --mt  Force Mastodon compatibility for tags (drop every incompatible characters inside tags)
        This option requires --tags
  -c, --category=STRING  Category for the videos, see below. (default: Films)
  --cca  License should be CreativeCommon Attribution (affects Youtube upload only)
  -p, --privacy=STRING  Choose between public, unlisted or private. (default: private)
  --disable-comments  Disable comments (Peertube only as YT API does not support) (default: comments are enabled)
  --nsfw  Set the video as No Safe For Work (Peertube only as YT API does not support) (default: video is safe)
  --nfo=STRING  Configure a specific nfo file to set options for the video.
                By default Prismedia search a .txt based on video name
                See nfo_example.txt for more details
  --platform=STRING  List of platform(s) to upload to, comma separated.
                     Supported platforms are youtube and peertube (default is both)
  --language=STRING  Specify the default language for video. See below for supported language. (default is English)
  --publishAt=DATE  Publish the video at the given DATE using local server timezone.
                    DATE should be on the form YYYY-MM-DDThh:mm:ss eg: 2018-03-12T19:00:00
                    DATE should be in the future
                    For Peertube, requires the "atd" and "curl utilities installed on the system
  --thumbnail=STRING    Path to a file to use as a thumbnail for the video.
                        Supported types are jpg and jpeg.
                        By default, prismedia search for an image based on video name followed by .jpg or .jpeg
  -h --help  Show this help.
  --version  Show version.

  Category is the type of video you upload. Default is films.
  Here are available categories from Peertube and Youtube:
    music, films, vehicles,
    sports, travels, gaming, people,
    comedy, entertainment, news,
    how to, education, activism, science & technology,
    science, technology, animals

  Language of the video (audio track), choose one. Default is English
  Here are available languages from Peertube and Youtube:
    Arabic, English, French, German, Hindi, Italian,
    Japanese, Korean, Mandarin, Portuguese, Punjabi, Russian, Spanish


  • Support of all videos arguments (description, tags, category, licence, ...)


If your server uses peertube before 1.0.0-beta4, use the version inside tag 1.0.0-beta3!


inspired by peeror and youtube-upload