YouTube2PeerTube is a bot written in Python3 that mirrors YouTube channels to PeerTube channels as videos are released in a YouTube channel.
Go to file
Mister Monster 6c054e492d change addresses 2023-08-16 04:56:20 +00:00
LICENSE Initial commit 2019-10-18 18:15:05 -05:00 change addresses 2023-08-16 04:56:20 +00:00
channels_timestamps.csv add empty channels_timestamps.csv 2019-10-18 23:18:21 +00:00
example_config.toml add internal to pt_privacy example options (#26) 2022-05-29 23:59:41 -05:00
pt_languages_categories.txt documentation on Peertube languages and categories 2019-11-22 16:43:53 -06:00
requirements.txt Bump urllib3 from 1.25.7 to 1.26.5 (#23) 2021-09-06 16:09:23 -04:00 Update 2019-11-27 17:34:50 -06:00 fix Response 400 error on use_pt_http_import=true (#20) 2021-03-05 20:58:36 -06:00



Peertube appears to be set to implement this type of functionality in the server directly, so as a result, if upon release of this feature it performs all the functions of this script, this script will be depracated.

If for some reason the peertube functionality requires the YouTube API or YouTube credentials, this script will continue to be maintained.

YouTube2PeerTube is a bot written in Python3 that mirrors YouTube channels to PeerTube channels as videos are released in a YouTube channel.

It checks YouTube channels periodically, when new videos are found, it mirrors them with metadata to PeerTube corresponding peertube channels.

This tool supports multiple channels, and supports mirroring each YouTube channel to a user defined PeerTube channel and instance that can be different for each YouTube channel being mirrored.

This tool does not use YouTube APIs. Instead, it subscribes to channels via RSS. This is a primary feature, this tool will always avoid the YouTube API, and no features will be implemented that require the YouTube API.

If you need to archive a YouTube channel with lots of existing videos, this tool is not for you. This tool starts mirroring channels from the time they are added to the config and will not mirror all historical videos that exist in a YouTube channel. A tool that provides this functionality is available


To install, clone the repository to a directory on your machine. Then, navigate to that directory in a terminal and run:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

This will create a virtual environment for the tool and install all dependencies required to run.


This tool depends on:

  • pafy for downloading of YouTube content.

  • feedparser for parsing of RSS data

  • TOML for the configuration file

  • MultipartEncoder from requests_toolbelt

  • urllib.request, requests, mimetypes, time, json and os from the Python standard library

It also contains heavily modified components from prismedia for uploading videos and metadata to PeerTube.


IMPORTANT: If you are updating this tool be sure to check the new example configuration against your configuration, as some parameters may be added or removed or otherwise changed.

An example configuration file is found at example_config.toml. Copy this to config.toml and replace the fields with your information, and add channels as necessary.

The configuration file is found at config.toml. It allows you to configure the poll frequency for all YouTube channels, download directory for videos and metadata, whether to keep the videos after upload (for archiving purposes) as well as per channel options such as YouTube channel info, corresponding PeerTube channel info and auth, and appendable tags and descriptions.

If you set <use_pt_http_import> to "true", the bot will not download videos at all. It will simply pass the YT video URL to PeerTube directly. Because of this, if you choose to use this option, you will not be able to locally transcode videos, nor will you be able to archive them.

Each channel is capable of mirroring to a different PeerTube account and instance, and is capable of appending tags and description information on a per channel basis.

All videos and metadata are stored in <video_download_dir> as defined in the config, in a subdirectory with the same name as the channel in the config, one directory per channel. All videos and metadata are named after the YouTube video ID. For each video, there should be 3 files: a video file, a thumbnail (jpg) and a text file containing metadata.

If <delete_videos> is set to True, videos and metadata will be deleted from the download directory after upload.

Running the bot

To run the bot, simply run The bot will run indefinitely until stopped.

The first time a channel is found in the config, the most recent videos returned by the youtube RSS endpoint are mirrored, and a new entry is added to channels_timestamps.csv with the timestamp of the last video. Subsequently each channel is checked for an entry in channels_timestamps.csv and only videos later than the last timestamp for the channel's entry are mirrored. The tool decides if it is the first time a channel is found based on whether it has an entry in channels_timestamps.csv. It is designed this way so that the tool can be stopped and restarted without attempting to upload duplicate videos when restarted.

After that, the tool polls all channels in config.toml periodically based on the parameter <poll_frequency> which is in minutes, and mirrors all new videos for each channel as they are found.

Any time the configuration is changed, the bot must be restarted.

Future improvements

  • Auth info for PeerTube channels is currently stored in plaintext in config.toml. This is insecure and needs to be changed.

  • It would be better if the tool were to run as a cron job or daemon rather than an ongoing python process.

  • implement logging

  • Sometimes a YouTube video or its metadata might be updated for some reason or other, it would be nice if the tool were able to update the mirrored video on PeerTube when this happens, and potentially archive or remove the previous version of the video.

  • Currently there is no way to abide by the upload cap for PeerTube instances, this can lead to errors. It is recommended for now that you run your own PeerTube instance with no cap, or select PeerTube instances with high enough caps to account for the upload frequency of the YouTube accounts you are mirroring, and lower the upload resolution if needed (resolution preference not implemented yet). I would like to implement queue functionality for videos when the cap is reached, but I am unsure when I will implement this.

  • A TUI would be nice for adding channels and restarting the bot.

See open issues for more details.

Please open issues if you find any problems or if you have a feature request. Pull requests are always welcome, however feature requests and pull requests will not be implemented if they are out of the scope of the project or if they cause issues with other existing features.


Thanks to the mps-youtube project for pafy, and thanks to LecygneNoir for the prismedia project. Thank you Tom for TOML and as always, Guido and the Python team.

If you want to buy me a coffee (or beer!) for this or anything else I have done:

XMR (preferred): 46zFAv8KHaKVuYDTJ15TXAah6SCXw88Dx9UhTuUJa6ydb8m9uGLaYE3AX5JPFhsJjJ6w7NMc7vNYwQPhGkt3tE2L7pwgrte

BTC: bc1qmulvfg7ctj0crpfvq9wux5j8xg9qskrj6xcf0x

LTC (in case BTC is too expensive): ltc1qrh6l8rf0pr0upalcjr2de4hc8xzczcg7slmygv

ETH: 0xAF5621F1f484aa10042Ab84c4C5D436C89D06262

I will donate some portion of anything I recieve, at my discretion, to other FOSS projects that I use.