streams.json is a file store in the site root use for stream url for radio, tv, webradio or webtv.
It allows to list stream url for radio, tv, webradio or webtv. It is a JSON file that contains information about the different streams of the website.
Because it's something quick and easy to create. It also allows you to have more information about your streams. With our tool you can generate your streams.json file easily.
In the site root. Just next to the robots.txt file or favicon.ico.
Like: https://domain.tld/streams.json
No, you can put it if you want and if you need it. In the near futur we would like directories use it to update or save informations automatically.
Language: 2-letter ISO-639-1 Codes, lower case (fr)
Country and Location(s): ISO 3166-1 Alpha-2 code, upper case (FR)
The format is defined by a JSON Schema: streams.schema.json. A complete example is available in streams.json.
Lists are always arrays, even when they hold a single item, and unknown properties are rejected.
| Property | Type | Required | Description |
|---|---|---|---|
$schema |
string (URL) | no | URL of the schema, enables validation and autocompletion in editors |
version |
string | yes | Version of the format, 0.5.0 |
generated_at |
string (RFC 3339 date-time) | no | When the file was generated |
name |
string | yes | Name of the broadcaster or network |
description |
string | no | Short description |
url |
string (URL) | no | Website |
location |
string (country code) | no | Country of the broadcaster |
city |
string | no | City of the broadcaster |
languages |
array of language codes | no | Languages of the broadcaster |
logo |
array of logos | no | Logos of the broadcaster |
stations |
array of stations | yes | At least one station |
| Property | Type | Required | Description |
|---|---|---|---|
name |
string | yes | Name of the station |
description |
string | no | Short description |
genre |
string | no | Genre, as free text (Pop, Rock) |
url |
string (URL) | no | Web page of the station |
languages |
array of language codes | no | Languages of the station |
logo |
array of logos | no | Logos of the station |
streams |
array of streams | yes | At least one stream, one per format and bitrate |
| Property | Type | Required | Description |
|---|---|---|---|
type |
string | yes | Format in lower case (mp3, aac, ogg, hls…) |
bitrate |
integer | no | Bitrate in kbit/s |
server |
array of servers | yes | At least one server delivering this stream |
| Property | Type | Required | Description |
|---|---|---|---|
url |
string (URL) | yes | URL of the stream on this server |
priority |
integer | no | Order in which servers should be tried, 1 first |
location |
string (country code) | no | Country the server is located in |
| Property | Type | Required | Description |
|---|---|---|---|
url |
string (URL) | yes | URL of the image |
type |
string | no | Shape of the logo (square) |
size |
integer | no | Width in pixels |
With check-jsonschema:
pip install check-jsonschema
check-jsonschema --schemafile https://raw.githubusercontent.com/streams-json/streams.json/main/streams.schema.json streams.jsonAny other JSON Schema validator supporting draft 2020-12 works too.
- Replace the
_streams.json_*_headers withversion(and optionally$schemaandgenerated_at)._streams.json_info_and_streams.json_url_are removed. streamsis always an array, even with a single stream.serveris always an array, even with a single server.- A stream no longer has a
urlproperty: each URL goes in aserverentry, with apriorityif the order matters.
On our website you can:
- generate your streams.json file
- update your streams.json file to the last version to be up to date
- check your streams.json file
The playlist generator turns a streams.json file into m3u or xspf playlists, one per stream, packed in a zip file. It runs in the browser; a command line version is available in playlist-php.
To let it, and other web tools, read your file from its URL, serve streams.json with the Access-Control-Allow-Origin: * header.
- MOROW
- and many more…
Are you using streams.json? Add your website to the list!