]> git.immae.eu Git - github/Chocobozzz/PeerTube.git/blame - support/doc/import-youtube.md
add import-youtube guide inside documentation (#298)
[github/Chocobozzz/PeerTube.git] / support / doc / import-youtube.md
CommitLineData
2519d9fe
L
1# Import videos from Youtube guide
2
3You can use this script to import videos from Youtube channel to Peertube.
4Be sure you own the videos or have the author's authorization to do so.
5
6 - [Installation](#installation)
7 - [Usage](#usage)
8
9## Installation
10
11## Prerequisites
12
13You need at least 512MB RAM to run the script.
14Importation can be launched directly from a peertube server (in this case you already have dependencies installed :+1:) or from a separate server, even a dekstop PC.
15
16### Dependencies
17
18If you do not run the script from a Peertube server, you need to follow the steps of the [dependencies guide](dependencies.md).
19
20### Installation
21
22Clone the Peertube repo to get the latest version inside your server:
23
24```
25git clone https://github.com/Chocobozzz/PeerTube.git
26CLONE="$(pwd)/Peertube"
27```
28
29Run ``yarn install``
30```
31cd ${CLONE}
32yarn install
33```
34
35Build server tools:
36```
37cd ${CLONE}
38npm run build:server
39```
40
41
42## Usage
43
44You are now ready to run the script :
45
46```
47cd ${CLONE}
48node dist/server/tools/import-youtube.js -u "PEERTUBE_URL" -U "PEERTUBE_USER" --password "PEERTUBE_PASSWORD" -y "YOUTUBE_URL"
49```
50
51 - PEERTUBE_URL : the full URL of your peertube server where you want to import, eg: https://peertube.cpy.re/
52 - PEERTUBE_USER : your peertube account where videos will be uploaded
53 - PEERTUBE_PASSWORD : password of your peertube account
54 - YOUTUBE_URL : the youtube channel you want to import. Supports Youtube channel (eg https://www.youtube.com/channel/ChannelId) or Youtube user (eg: https://www.youtube.com/c/UserName or https://www.youtube.com/user/UserName)
55
56 The script will get all public videos from Youtube, download them, then upload to Peertube.
57 Already downloaded videos will not be uploaded twice, so you can run and re-run the script in case of crash, disconnection, ... without problem.