TDTChannels/CONTRIBUTING.md

5.1 KiB

Para hacer más sencillas las contribuciones, a continuación indico las características que deben cumplir los aportes hacia este repositorio, en la medida de lo posible. Si no te atreves a lanzarlo como Pull Request, no sabes como hacerla de forma correcta, o tienes dudas sobre algún concepto, nos puedes hacer llegar la petición mediante este sencillo formulario.

Explicación de cada columna y posibles valores

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. Con excepción de los canales internacionales, en los que si ya existe el país mencionado, el propuesto debe indicarse el último de ese país en concreto.

Televisión

Canal

El nombre oficial del canal.

M3U8

Se aceptan los siguientes formatos de stream. Ambos formatos tienen obligatoria su obtención a través de la plataforma oficial del emisor. Han de ser emisiones en directo.

  • m3u8: Priorizando las opciones master.m3u8 y playlist.m3u8. Este formato es compatible con la mayoría de reproductores.
  • youtube: Si la cadena emite vía YouTube. Con formato https://youtu.be/XXXXXX si el tiempo de vida del stream es superior a dos semanas, y con el formato /channel/.../live en caso contrario. Este formato es compatible con la aplicación Android TDTChannels, la web, y la lista W3U.
  • stream: Si emite de forma embebida en cualquier otro formato. Este formato es compatible con la aplicación Android TDTChannels, la web, y la lista W3U.

Si el canal emite:

  • geolocalizado a nivel español, se deberá añadir la coletilla # GEO.
  • geolocalizado a nivel catalán, se deberá añadir la coletilla # GEOCAT.
  • En otro idioma que no sea el español, se deberá indicar con el código ISO_639-1. Por ejemplo, si emite en Inglés será [m3u8 # EN].
  • 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.

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.

Excepciones:

  • No se pueden subir enlaces convertidos a m3u8 de Youtube, Twitch, Dailymotion, Vimeo, etc. Pues 'caducan' muy rápido.

Web

En este apartado se debería indicar la web de dónde sale el stream.

  • Incluir el que más represente la emisión a mostrar.
  • Fuentes de datos, en orden de preferencia: Redes sociales del canal: Facebook, Twitter, YouTube; propio canal, etc.
  • Medida recomendada de 200x200.
  • Formato PNG, y si no es posible JPG.
  • Preferiblemente sin transparencias y con fondo blanco.
  • 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

  • NONAV: La emisión no funciona en navegadores web.
  • NOEM: El canal no emite online.
  • EMB: Si se trata de un video de Youtube.

En caso de tener más de un TAG de información, concatenar con comas y sin espacios. Los demás TAGs son de administración. Si deseas conocer más, contáctanos.

Radio

Igual que la televisión a excepción de los formatos aceptados para la reproducción.

Stream

Aplica lo mismo que para la TV. La preferencia siempre será la de elegir el stream. Formatos aceptados:

  • Stream
  • M3U8
  • M3U
  • MP3

Aviso general

Únicamente se recoge información externa, no se permite subir contenidos al repositorio.

Cúando se considera un canal de interés para TDTChannels?

El objetivo del proyecto es el de incluir todos los canales que emitan de forma legal para España. Por ello, cualquier canal que tenga su centro de emisión en España será incluido. Sin embargo, si se trata de emisiones internacionales, habrá un conjunto de criterios que serán los que determinen la inclusión del canal. Estos criterios se resumen en la importancia del canal a incluir. Empezando por el número de seguidores a nivel global (una buena metrica es Facebook y Twitter). Más info: https://github.com/LaQuay/TDTChannels/pull/1279#issuecomment-774562588

Requisitos de inclusión

Las emisiones deben cumplir los siguientes puntos:

  • La fuente debe ser la página oficial de la emisión.
  • El acceso debe ser directo, no se aceptarán emisiones previo registro / pago.
  • Deben ser visibles en España. Es el objetivo del proyecto. La mayoría del tiempo deben ser visibles en territorio español.

Vía Pull Request

En este documento encontrarás la información de como realizar la Pull Request

Vía Formulario

En este formulario podrás realizar la petición.

Gracias por colaborar!