X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=support%2Fdoc%2Ftools.md;h=26b44c83512ae434b281ac2719b3d51a3a1edd30;hb=bbe0f0645ca958d33a3f409b15166609733b663f;hp=8f897dbfa7f01a13e64d159c7499532213106936;hpb=a5f0521f035079528580530f11567c6b74149bad;p=github%2FChocobozzz%2FPeerTube.git diff --git a/support/doc/tools.md b/support/doc/tools.md index 8f897dbfa..26b44c835 100644 --- a/support/doc/tools.md +++ b/support/doc/tools.md @@ -1,15 +1,14 @@ # CLI tools guide - - [Installation](#installation) - - [Usage](#usage) + - [Remote tools](#remote-tools) - [import-videos.js](#import-videosjs) - [upload.js](#uploadjs) + - [Server tools](#server-tools) - [create-transcoding-job.js](#create-transcoding-jobjs) - [create-import-video-file-job.js](#create-import-video-file-jobjs) + - [prune-storage.js](#prune-storagejs) -## Installation - -## Prerequisites +## Remote Tools You need at least 512MB RAM to run the script. Scripts can be launched directly from a PeerTube server, or from a separate server, even a desktop PC. @@ -40,8 +39,6 @@ $ cd ${CLONE} $ npm run build:server ``` -## Tools - ### import-videos.js You can use this script to import videos from all [supported sites of youtube-dl](https://rg3.github.io/youtube-dl/supportedsites.html) into PeerTube. @@ -66,26 +63,34 @@ $ node dist/server/tools/import-videos.js \ * Vimeo: https://vimeo.com/xxxxxx * Dailymotion: https://www.dailymotion.com/xxxxx - The script will get all public videos from Youtube, download them and upload to PeerTube. - Already downloaded videos will not be uploaded twice, so you can run and re-run the script in case of crash, disconnection... +The script will get all public videos from Youtube, download them and upload to PeerTube. +Already downloaded videos will not be uploaded twice, so you can run and re-run the script in case of crash, disconnection... + +Videos will be publicly available after transcoding (you can see them before that in your account on the web interface). + ### upload.js You can use this script to import videos directly from the CLI. +Videos will be publicly available after transcoding (you can see them before that in your account on the web interface). + ``` $ cd ${CLONE} $ node dist/server/tools/upload.js --help ``` -## Tools to create jobs in the queue + +## Server tools + +These scripts should be run on the server, in `peertube-latest` directory. ### create-transcoding-job.js You can use this script to force transcoding of an existing video. ``` -$ npm run create-transcoding-job -- -v [videoUUID] +$ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-transcoding-job -- -v [videoUUID] ``` ### create-import-video-file-job.js @@ -93,5 +98,14 @@ $ npm run create-transcoding-job -- -v [videoUUID] You can use this script to import a video file to replace an already uploaded file or to add a new resolution to a video. ``` -$ npm run create-import-video-file-job -- -v [videoUUID] -i [videoFile] +$ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-import-video-file-job -- -v [videoUUID] -i [videoFile] +``` + +### prune-storage.js + +Some transcoded videos or shutdown at a bad time can leave some unused files on your storage. +To delete them (a confirmation will be demanded first): + ``` +$ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run prune-storage +``` \ No newline at end of file