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 194e2e4606 Merge branch 'release/v0.11.0' 6 months ago
prismedia Bump files to v0.11.0, fix #50 6 months ago
.gitignore gitignore .mp4 to avoid commiting test files 1 year ago
CHANGELOG.md Bump files to v0.11.0, fix #50 6 months ago
LICENSE initial commit 3 years ago
README.md Stripe the README from the full --help output to focus on some main features 7 months ago
poetry.lock Bump files to v0.11.0, fix #50 6 months ago
pyproject.toml Bump files to v0.11.0, fix #50 6 months ago
requirements.txt Add clint as requirement 6 months ago

README.md

Prismedia

Scripting your way to upload videos to peertube and youtube. Works with Python 3.5+.

Table of Contents

Installation and upgrade

From pip

Simply install with

pip install prismedia

Upgrade with

pip install --upgrade prismedia

From source

Get the source:

git clone https://git.lecygnenoir.info/LecygneNoir/prismedia.git prismedia

You may use pip to install requirements: pip install -r requirements.txt if you want to use the script directly.
(note: requirements are generated via poetry export -f requirements.txt)

Otherwise, you can use poetry, which create a virtualenv for the project directly
(Or use the existing virtualenv if one is activated)

poetry install

Configuration

Generate sample files with python -m prismedia.genconfig.
Then rename and edit peertube_secret and youtube_secret.json with your credentials. (see below)

Peertube

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

Youtube uses combination of oauth and API access to identify.

Credentials The first time you connect, prismedia will open your browser to ask 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.

Oauth:
The default youtube_secret.json should allow you to upload some videos.
If you plan a 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.

Usage

Support only mp4 for cross compatibility between Youtube and Peertube.
Note that all options may be specified in a NFO file! (see Enhanced NFO)

Here are some demonstration of main usage you would like!

Upload a video:

prismedia --file="yourvideo.mp4"

Specify description and tags:

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

Provide a thumbnail:

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

Publish on Peertube only, while using a channel and a playlist, creating them if they does not exist.:

prismedia --file="yourvideo.mp4" --platform=peertube --channel="Cooking recipes" --playlist="Cake recipes" --channelCreate --playlistCreate

Use a NFO file to specify your video options:
(See Enhanced NFO for more precise example)

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

Take a look at all available options with --help!

prismedia --help

Enhanced use of NFO

Since Prismedia v0.9.0, the NFO system has been improved to allow hierarchical loading. First of all, if you already used nfo, either with --nfo or by using videoname.txt, nothing changes :-)

But you are now able to use a more flexible NFO system, by using priorities. This allow you to set some defaults to avoid recreating a full nfo for each video

Basically, Prismedia will now load options in this order, using the last value found in case of conflict:
nfo.txt < directory_name.txt < video_name.txt < command line NFO < command line argument

You'll find a complete set of samples in the prismedia/samples directory so let's take it as an example:

$ tree Recipes/
Recipes/
├── cli_nfo.txt
├── nfo.txt
├── samples.txt
├── yourvideo1.mp4
├── yourvideo1.txt
├── yourvideo1.jpg
├── yourvideo2.mp4
└── yourvideo2.txt

By using

prismedia --file=/path/to/Recipes/yourvideo1.mp4 --nfo=/path/to/Recipes/cli_nfo.txt --cca

Prismedia will:

  • look for options in nfo.txt
  • look for options in samples.txt (from directory name) and erase any previous conflicting options
  • look for options in yourvideo1.txt (from video name) and erase any previous conflicting options
  • look for options in cli_nfo.txt (from the --nfo in command line) and erase any previous conflicting options
  • erase any previous option regarding CCA as it's specified in cli with --cca
  • take yourvideo1.jpg as thumbnail if no other files has been specified in previous NFO

In other word, Prismedia will use option given in cli, then look for option in cli_nfo.txt, then complete with video_name.txt, then directory_name.txt, and finally complete with nfo.txt

It allows to specify more easily default options for an entire set of video, directory, playlist and so on.

Strict check options

Since prismedia v0.10.0, a bunch of special options have been added to force the presence of parameters before uploading. Strict options allow you to force some option to be present when uploading a video. It's useful to be sure you do not forget something when uploading a video, for example if you use multiples NFO. You may force the presence of description, tags, thumbnail, ... All strict option are optionals and are provided only to avoid errors when uploading :-) All strict options can be specified in NFO directly, the only strict option mandatory on cli is --withNFO All strict options are off by default.

Available strict options:

  • --withNFO Prevent the upload without a NFO, either specified via cli or found in the directory
  • --withThumbnail Prevent the upload without a thumbnail
  • --withName Prevent the upload if no name are found
  • --withDescription Prevent the upload without description
  • --withTags Prevent the upload without tags
  • --withPlaylist Prevent the upload if no playlist
  • --withPublishAt Prevent the upload if no schedule
  • --withPlatform Prevent the upload if at least one platform is not specified
  • --withCategory Prevent the upload if no category
  • --withLanguage Prevent upload if no language
  • --withChannel Prevent upload if no channel

Features

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

Compatibility

  • If you still use python2, use the version 0.7.1 (no more updated)
  • If you use peertube before 1.0.0-beta4, use the version inside tag 1.0.0-beta3

Inspirations

Inspired by peeror and youtube-upload

Contributors

Thanks to: @Zykino, @meewan, @rigelk 😘