TDTChannels/CONTRIBUTING.md

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](https://forms.gle/vKnKwSMcUPydyQgR9).

## 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](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`. 
- 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]`.
- 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_.

#### Logo
- 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](https://github.com/LaQuay/TDTChannels/edit/master/CONTRIBUTING.md) encontrarás la información de como realizar la Pull Request

### Vía Formulario
En [este formulario](https://tdtchannels.com/peticion) podrás realizar la petición.


Gracias por colaborar!