# BitTorrent Streaming

## Streaming from BitTorrent

To stream from BitTorrent in the browser all you need is a `torrentId`. 

A `torrentId` can be an `infoHash`, `magnet` or `.torrent` file. 

Any torrent can be streamed by appending the `torrentId` to the seedess player URL `https://play.seedess.com/`

### InfoHash Example

The infoHash `ab3f1350ebe4563a710545d0e33e09a7b7943ecf` can be streamed directly from BitTorrent

InfoHash

{% code title="InfoHash" %}

```
ab3f1350ebe4563a710545d0e33e09a7b7943ecf
```

{% endcode %}

#### Video Player URL

Add the infoHash to the end of `https://play.seedess.com/`

{% code title="Video Player URL" %}

```
https://play.seedess.com/ab3f1350ebe4563a710545d0e33e09a7b7943ecf
```

{% endcode %}

#### Video Player Embed

You can embed the player in your HTML webpage using an `<iframe>`

{% code title="VIdeo Player HTML Embed" %}

```markup
<iframe src="https://play.seedess.com/ab3f1350ebe4563a710545d0e33e09a7b7943ecf"></iframe>
```

{% endcode %}

### Magnet Example

#### Magnet

A magnet is in the form

{% code title="Magnet" %}

```
magnet:?xt=urn:btih:ab3f1350ebe4563a710545d0e33e09a7b7943ecf
```

{% endcode %}

#### Player URL &#x20;

Generate the Player URL from the magnet by appending the magnet to the seedess player URL.&#x20;

{% hint style="info" %}
Do not URL encode the magnet. Add it as is.
{% endhint %}

{% code title="Video Player URL" %}

```
https://play.seedess.com/magnet:?xt=urn:btih:ab3f1350ebe4563a710545d0e33e09a7b7943ecf
```

{% endcode %}

#### Player HTML Embed

The player embed HTML can be created by placing the player URL in an `<iframe>`

{% code title="Video Player HTML Embed" %}

```markup
<iframe 
src="https://play.seedess.com/magnet:?xt=urn:btih:ab3f1350ebe4563a710545d0e33e09a7b7943ecf">
</iframe>
```

{% endcode %}

### .torrent URL example

For the best performance, you will need a `.torrent` URL. Torrent URLs contain the metadata required to stream torrents and thus have a faster initial load time.&#x20;

{% hint style="info" %}
&#x20;The .torrent URL must have CORS enabled. Otherwise you will need to host the .torrent on your own server.
{% endhint %}

#### Torrent URL

Given a `.torrent URL` you can create the Video Player URL

{% code title="Torrent URL" %}

```
https://cdn.seedess.com/torrent/ab3f1350ebe4563a710545d0e33e09a7b7943ecf.torrent
```

{% endcode %}

#### Video Player URL

Create the Video Player URL by adding the torrent to the end of `http://play.seedess.com/`

{% hint style="info" %}
The .torrent file URL should not be URL encoded. Just paste it as is.
{% endhint %}

{% code title="Video Player URL" %}

```
https://play.seedess.com/https://cdn.seedess.com/torrent/ab3f1350ebe4563a710545d0e33e09a7b7943ecf.torrent
```

{% endcode %}

#### Video Player Embed

The Player Embed code can create by using the URL as the src of your iframe

{% code title="Video Player Embed HTML" %}

```markup
<iframe 
src="https://play.seedess.com/
https://cdn.torcdn.com/torrent/ab3f1350ebe4563a710545d0e33e09a7b7943ecf.torrent
"></iframe>
```

{% endcode %}

### Combined BitTorrent Streaming

Streaming from Bittorrent doesn't give you much advantage if you don't use it to augment your existing HTTP Streaming or CDN.&#x20;

Let's combine Bittorrent Streaming with a CDN

#### Magnet

First we need a magnet

{% code title="Magnet" %}

```
magnet:?xt=urn:btih:ab3f1350ebe4563a710545d0e33e09a7b7943ecf
```

{% endcode %}

#### CDN URL

Then we need the URL of the video on different CDNs

{% code title="Fast Cast Video URL" %}

```
https%3A%2F%2Ffastcast.nz%2Fdownloads%2Fawakening-new-zealand-4k.mp4
```

{% endcode %}

{% code title="BTorrent Video URL" %}

```
https%3A%2F%2Fwebseed.btorrent.xyz%2Fawakening-new-zealand-4k.mp4
```

{% endcode %}

We can add other CDN URLs such as Amazon and Cloudflare URLs.&#x20;

We add the URLs to the video player URL using a parameter `ws` which stands for WebSeed. This is a BitTorrent term for a CDN or URL that hosts the video.&#x20;

{% hint style="info" %}
Please note the URLs are URL Encoded as they are parameters to the magnet URL and looks like `&ws={encoded URL}`.&#x20;
{% endhint %}

We can add as many `ws` parameter as we want, however it's good to keep it under 4 URLs for performance reasons.&#x20;

{% code title="Video Player URL" %}

```
https://play.seedess.com/magnet:?xt=urn:btih:ab3f1350ebe4563a710545d0e33e09a7b7943ecf&ws=https%3A%2F%2Ffastcast.nz%2Fdownloads%2Fawakening-new-zealand-4k.mp4&ws=https%3A%2F%2Fwebseed.btorrent.xyz%2Fawakening-new-zealand-4k.mp4
```

{% endcode %}

#### Video Player Embed

The video player embed uses wraps the player in an Iframe

{% code title="Video Player HTML Embed" %}

```markup
https://play.seedess.com/magnet:?xt=urn:btih:ab3f1350ebe4563a710545d0e33e09a7b7943ecf&ws=https%3A%2F%2Ffastcast.nz%2Fdownloads%2Fawakening-new-zealand-4k.mp4&ws=https%3A%2F%2Fwebseed.btorrent.xyz%2Fawakening-new-zealand-4k.mp4
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.seedess.com/bittorrent-streaming.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.