From f886b9b8477452cb0e256c3fb41133be946daa00 Mon Sep 17 00:00:00 2001 From: Dessalines Date: Thu, 8 Feb 2024 04:43:35 -0500 Subject: [PATCH] Add instructions for Torrent-Streaming to docs. (#291) * Add instructions for Torrent-Streaming to docs. - These instructions can then be linked to in UIs, where the post_url is a torrent magnet link. - Context: https://github.com/LemmyNet/lemmy/issues/4204 * Fixing up language, and wiki link. --- src/users/02-media.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/src/users/02-media.md b/src/users/02-media.md index 936ed4e..6104ba7 100644 --- a/src/users/02-media.md +++ b/src/users/02-media.md @@ -27,3 +27,36 @@ The main type of content in Lemmy is text which can be formatted with Markdown. Lemmy also allows sharing of images and videos. To upload an image, go to the _Create post_ page and click the little image icon under the _URL_ field. This allows you to select a local image. If you made a mistake, a popup message allows you to delete the image. The same image button also allows uploading of videos in .gif format. Instead of uploading a local file, you can also simply paste the URL of an image or video from another website. Note that this functionality is not meant to share large images or videos, because that would require too many server resources. Instead, upload them on another platform like [PeerTube](https://joinpeertube.org/) or [Pixelfed](https://pixelfed.org/), and share the link on Lemmy. + +## Torrents + +Since Lemmy doesn't host large videos or other media, users can share files using [BitTorrent](https://en.wikipedia.org/wiki/BitTorrent) links. In BitTorrent, files are shared not by a single user, but by _many users_ at the same time. This makes file sharing efficient, fast, and reliable, as long as several sources are sharing the files. + +Lemmy supports posting torrent magnet links (links that start with `magnet:`) in the post _URL_ field, or as markdown links within comments. + +With this, Lemmy can serve as an alternative to centralized media-centric services like YouTube and Spotify. + +### How to watch Torrents + +#### Beginner + +To easily stream videos and audio on Lemmy, you can use any of the following apps. After clicking on a torrent link in Lemmy, a dialog will pop up asking you to open the link in the app. + +- [Stremio](https://www.stremio.com/) (Desktop, Android) +- [WebTorrent Desktop](https://webtorrent.io/desktop/) (Desktop) +- [Popcorn Time](https://github.com/popcorn-official/popcorn-desktop) (Desktop) +- [xTorrent](https://play.google.com/store/apps/details?id=com.gamemalt.streamtorrentvideos) (Android) + +#### Expert + +For those who would like to help share files, you can use any of the following torrent clients. + +- [qBittorrent](https://qbittorrent.org/) (Desktop) +- [Deluge](https://www.deluge-torrent.org/) (Desktop) +- [Transmission](https://transmissionbt.com/) (Desktop) +- [LibreTorrent](https://gitlab.com/proninyaroslav/libretorrent) (Android) + +If you'd like, you can also set up a media server to view this content on any device. Some good options are: + +- [Jellyfin](https://jellyfin.org/) (Movies, TV, Music, Audiobooks) +- [Navidrome](https://www.navidrome.org/) (Music)