1
0
Fork 0
mirror of https://github.com/LaQuay/TDTChannels.git synced 2024-10-31 14:41:12 +01:00
TDTChannels/CONTRIBUTING.md

73 lines
4.3 KiB
Markdown
Raw Normal View History

2020-03-23 22:08:24 +01:00
Para hacer más sencillas las contribuciones, a continuación indico lo que deben cumplir los aportes hacia este repositorio, en la medida de lo posible.
2019-01-27 14:32:26 +01:00
2020-03-23 22:08:24 +01:00
Si no te atreves a lanzarlo como _Pull Request_, puedes incluirlo como Issue, pero siempre tratando de dar la mayor información posible, y, como mínimo, enlace de _stream_ y web de procedencia.
## Explicación de cada columna y posibles valores
2020-04-25 11:00:25 +02:00
Emplazar la nueva emisión al final de su categoría, así es más sencillo para nosotros después moverlo a la posición correspondiente.
2020-03-23 22:08:24 +01:00
2020-05-03 15:07:56 +02:00
### Televisión
2020-04-09 00:00:16 +02:00
2020-03-23 22:08:24 +01:00
#### Canal
El nombre oficial del canal.
#### M3U8
2020-04-25 11:00:25 +02:00
Se aceptan los siguientes formatos de _stream_. Ambos formatos tienen obligatoria su obtención a través de la plataforma oficial del emisor.
2020-03-23 22:08:24 +01:00
2020-04-25 11:00:25 +02:00
- **m3u8**: Priorizando las opciones `master.m3u8` y `playlist.m3u8`. Este formato es compatible con la mayoría de reproductores.
2020-05-09 00:48:12 +02:00
- **youtube**: Si la cadena emite vía _YouTube_. Con formato `https://youtu.be/XXXXXX` si el tiempo de vida del stream es superior a un mes, y con el formato `/live` en caso contrario. Este formato únicamente es compatible con la lista W3U y la aplicación Android TDTChannels.
2020-04-25 11:00:25 +02:00
- **twitch**: Si la cadena emite vía _Twitch_. Este formato únicamente es compatible con la aplicación Android TDTChannels.
- **dailymotion**: Si la cadena emite vía _Dailymotion_. Este formato únicamente es compatible con la aplicación Android TDTChannels.
- **vimeo**: Si la cadena emite vía _Vimeo_. Este formato únicamente es compatible con la aplicación Android TDTChannels.
2020-03-23 22:08:24 +01:00
Si el canal emite:
- [geolocalizado](https://github.com/LaQuay/TDTChannels/wiki/FAQs#diferencia-entre-una-emisi%C3%B3n-geo-y-no-geo) a **nivel español**, se deberá añadir la coletilla `# GEO`.
- [geolocalizado](https://github.com/LaQuay/TDTChannels/wiki/FAQs#diferencia-entre-una-emisi%C3%B3n-geo-y-no-geo) a **nivel catalán**, se deberá añadir la coletilla `# GEOCAT`.
2020-03-24 21:26:58 +01:00
- En otro idioma que no sea el español, se deberá indicar con el código [ISO_639-1](https://es.wikipedia.org/wiki/ISO_639-1). Por ejemplo, si emite en Inglés será `[m3u8 # EN]`.
2020-03-23 22:08:24 +01:00
- Diferentes calidades vía enlace para forzar el _SD_ o _HD_, entonces se podrán indicar con las coletillas `# SD` o `# HD`.
- Varias opciones de emisión `p.e. +24 de TVE`, estas se podrán indicar con las coletillas `# 1`, `# 2`, etc.
2020-03-23 22:15:56 +01:00
Se pueden combinar diferentes opciones concatenandolas. Por ejemplo un canal en _HD_ y geolocalizado a catalunya sería `[m3u8 # GEOCAT # HD]`. Preferentemente manteniendo el orden de los puntos anteriores.
2019-01-27 14:32:26 +01:00
2020-03-23 22:08:24 +01:00
Excepciones:
2020-03-23 22:09:57 +01:00
2020-04-25 11:00:25 +02:00
No se pueden subir enlaces convertidos a _m3u8_ de _Youtube_, _Twitch_, _Dailymotion_, _Vimeo_, etc. Pues caducan muy rápido.
2020-02-24 15:13:34 +01:00
2020-03-23 22:08:24 +01:00
#### Web
En este apartado se debería indicar la web de dónde sale el _stream_.
2020-02-24 15:13:34 +01:00
2019-01-27 14:32:26 +01:00
#### Logo
2020-03-28 12:37:11 +01:00
- Incluir el que más represente la emisión a mostrar.
2020-04-25 11:00:25 +02:00
- Fuentes de datos, en orden de preferencia: Redes sociales del canal, _Facebook_, _Twitter_, _YouTube_, propio canal, etc.
- Medida recomendada de 320x320 - 400x400.
2019-01-27 14:32:26 +01:00
- Formato PNG, y si no es posible JPG.
2019-01-27 15:19:19 +01:00
- Preferiblemente sin transparencias y con fondo blanco.
2020-03-23 22:08:24 +01:00
- No es necesaria la aparición explicita del nombre del canal en el logo.
#### EPG ID
No indiques nada en este campo, lo modificaremos nosotros a posterior.
#### Info
2020-03-28 12:37:11 +01:00
- `W3U`: La emisión introducida en el apartado `WEB` es reproducible por _Wiseplay_. De esta forma se incluirá como _stream_ en dicha lista.
- `NONAV`: La emisión no funciona en navegadores debido a [CORS](https://developer.mozilla.org/es/docs/Web/HTTP/Access_control_CORS).
- `CODEC`: El canal necesita de un códec especial para ser reproducido.
2020-05-03 15:07:56 +02:00
- `WICE`: Exclusivamente para _Wiseplay_. Indica si el _stream_ ha de ser `"isHost": "false"`.
2020-05-09 00:48:12 +02:00
- `WEMB`: Exclusivamente para _Wiseplay_. Indica si el _stream_ ha de ser `"embed": "true"`, por ejemplo cuando se incluye un enlace a YouTube con `/live`.
2020-03-23 22:08:24 +01:00
2020-03-24 10:55:23 +01:00
En caso de tener más de un `TAG` de información, concatenar con comas y sin espacios.
2020-03-23 22:08:24 +01:00
### Radio
2020-05-03 15:07:56 +02:00
Igual que la televisión a excepción que el campo `EPG ID` no existe, y de los formatos aceptados para la reproducción.
2020-03-23 22:08:24 +01:00
#### Stream
2020-05-03 15:07:56 +02:00
Aplica lo mismo que para la TV. La preferencia siempre será la de elegir el stream en _m3u8_. Formatos aceptados:
- M3U8
- M3U
- MP3
- Stream
2020-03-23 22:08:24 +01:00
## Aviso general
- Únicamente se recoje información externa, no se permite subir contenidos al repositorio.
2019-01-27 15:16:11 +01:00
Gracias por colaborar!