link to openapi live spec
[oweals/peertube.wiki.git] / Home.md
1 # External Interaction
2
3 - [Toot new videos on Mastodon automatically (with Python)](https://github.com/PhieF/MiscConfig/blob/master/Peertube/peertubetomasto.py)
4 - [Seed automatically with some bash-fu and WebTorrent Desktop (in french)](https://linuxfr.org/users/yolo42/journaux/repliquer-ses-videos-peertube-premiers-pas)
5
6 - [Peeror: Scripting video uploads (with Python)](https://git.rigelk.eu/rigelk/peeror/wiki) [should still work and be easy to hack on, but in case it doesn't because of a change of PeerTube's API, please use `prismedia` below - it is a bit more complex but is keeping pace with PeerTube much more closely]
7 - [Example with Peeror: Scripting automatic mirror of a YouTube channel/playlist to PeerTube (with Python)](https://git.rigelk.eu/rigelk/peeror) [same as above]
8 - [Prismedia: Scripting video uploads to PeerTube and YouTube at the same time (with Python)](https://git.lecygnenoir.info/LecygneNoir/prismedia)
9
10 The API is also [documented via OpenAPI](https://docs.joinpeertube.org/api.html).
11
12 # Discover other PeerTube servers
13 There is now a dynamic list at [instances.peertu.be](https://instances.peertu.be/instances), maintained by [@Chocobozzz](https://github.com/Chocobozzz). It is not playing any role in the federation process at the moment, but it's a nice aid if you want to discover instances or be discovered.
14
15 <details>
16   <summary>other options we strongly advise against using</summary>
17 If you want to follow them automatically as they come you have 2 scripts, but *then beware that you blindly trust every other admin for enforcing sane moderation policies* :
18 * [Peetube AutoDiscover](https://framagit.org/Jorropo/peertube-autodiscover) by Jorropo, that uses following and followers list of nodes you already follow to discover new nodes.
19     - Can discover nodes unlisted in the official list (if an admin forgot to add their node in the official list this isn't a problem) as it recursively asks nodes you already know.
20     - Doesn't require a central node exchange point (node list)
21     - More secure than shell script (shell script use file as variable for storage of login token)
22 * [script from Skid](https://github.com/Chocobozzz/PeerTube/issues/406#issuecomment-397452809) and [python3 version](https://framagit.org/Jorropo/peertube-autodiscover/blob/master/updateFromInstancesList.py)
23     - Faster
24     - Protects privacy (maybe if a node isn't listed on [instances.peertu.be](https://instances.peertu.be/instances) there is a reason)
25
26 You can do a cron like `*/10 * * * * /opt/peertube-autofollow.py >/dev/null 2>&1` to automate its update.
27 </details>
28
29 # Other Documentations
30
31 The main documentation is now on http://docs.joinpeertube.org/