Manual Del Usuario de PalcoTV
Manual Del Usuario de PalcoTV
Manual Del Usuario de PalcoTV
Rev. 27.05.2016
Rev. 27.05.2016
Introduccin: Qu es M3U?
M3U es un formato de archivo que almacena listas de reproduccin de medios, creado
inicialmente para Winamp, pero hoy en da se extiende su uso para multitud de programas
multimedia. Se trata de un archivo de texto plano en el que se ordenan los enlaces a las
fuentes de medios siguiendo una sintaxis o formato que se ha adaptado para su uso en
PalcoTV aprovechando todas las caractersticas de Kodi. Si el archivo est codificado como
UTF-8 recibe el nombre de M3U8.
Un ejemplo de lista M3U en PalcoTV con sus etiquetas descriptivas del enlace en color verde
Rev. 27.05.2016
Rev. 27.05.2016
#EXTINF:-1,Ejemplo,tvg-wall=http://img.de/asgpoasg.png,tvg-logo=http://img.com/aa.png
http://www.video.com/video.avi
Como la lnea del ttulo excede del ancho de la pantalla vers que por el ajuste de lnea
aparecern varias pero recuerda que es slo una nica lnea. A continuacin del ttulo, y sin
dejar ningn salto de lnea ni espacio en blanco por delante, pegamos la URL.
Grupos de canales
En la lnea del ttulo tambin se puede asignar el canal a un grupo de canales:
#EXTINF:-1,Ejemplo de canal,group-title=TDT,tvg-logo=...,tvg-wall=...
Recuerda que PalcoTV reconocer los parmetros sin importar el orden en el que pongas el
group-title, tvg-logo y tvg-wall. Como veremos ms adelante, el group-title es incompatible
con los enlaces mltiples (multilinks y multiparsers).
Esta opcin se implement para leer determinadas listas M3U de decos ms que
para edicin de listas M3U propias de PalcoTV. Puede presentar incompatibilidades
si se utiliza con enlaces #multi al modificar PalcoTV el ttulo que se muestra.
Rev. 27.05.2016
Lneas de comentarios
Para evitar que PalcoTV interprete un elemento como un enlace de vdeo, se implement la
opcin de aadir comentarios, algo muy habitual al inicio de una lista para describir su
contenido. Tan solo hay que poner el smbolo almohadilla (#) delante del ttulo. Veamos un
ejemplo:
#EXTINF:-1,#Esto es un comentario del autor
#EXTINF:-1,#Puedes aadir ms lneas comentadas sin necesidad de aadir saltos de lnea
Rev. 27.05.2016
Acortadores de enlaces
PalcoTV incorpor en su versin 0.2.9 soporte de enlaces cortos, concretamente de hasta 255
servicios web acortadores de enlaces (tinyurl, bit.ly, etc) a travs de longURL.org.
Inicialmente lo reconoce como enlace IP, aparece en la lista con la coletilla [HTTP] y es en el
momento de su reproduccin cuando determina la URL original.
Rev. 27.05.2016
m3u:http://pastebin.com/raw.php?i=i8sgHaW
Un
ejemplo de lista: Discografa de Roxette
Rev. 27.05.2016
De esta forma resulta muy sencillo hacer listas de discografas musicales combinadas con
enlaces a videoclips o conciertos alojados en Youtube, por ejemplo.
NOTA: Recuerda que en Kodi puedes activar el modo repeticin, reproduccin continua y
aleatoria en el panel lateral izquierdo ;)
Rev. 27.05.2016
Sinopsis o descripcin
Una herramienta ms para dar un aspecto atractivo a nuestra lista es la posibilidad de aadir
un breve texto descriptivo o sinopsis tanto en enlaces simples como en #multi.
En la versin 0.3.5 an no est habilitada esta herramienta para todo tipo de enlaces,
pero poco a poco se ir implementando.
Rev. 27.05.2016
Regex de series
PalcoTV implement en la versin 0.3.0 una potente herramienta para aadir en una sola
lnea una serie completa alojada en SeriesAdicto. Ya en la versin 0.3.1 publicada el 22 de
abril de 2015 se habilita esta funcin para SeriesYonkis, Series.Mu, SeriesFLV y
SeriesBlanco. La sintaxis no puede ser ms sencilla:
#EXTINF:-1,THE WALKING DEAD (Serie completa)
serie:http://www.seriesadicto.com/a9s8g7a.html
Scraper de pelculas
Un scraper permite autocompletar la informacin artstica de una pelcula o lbum de msica.
En el scraper de PalcoTV se accede a IMDB y themoviedb.org para obtener estos parmetros:
Poster, Fanart, Ao, Duracin, Director, Guionista(s), Reparto, Sinopsis, Puntuacin en IMDB,
Nmero de votos, URL del triler en Youtube, y cuatro fotogramas de la pelcula (an en fase
experimental). Los resultados se obtienen en espaol por defecto.
Esta herramienta crea un archivo M3U en la carpeta kodi/userdata/tmp donde adems de
almacenar todos los enlaces tal como aparecen en una lista creada recopila las imgenes e
informacin tcnica y artstica de una pelcula. Una vez creado el archivo, el usuario debe
moverlo a la carpeta kodi/userdata/playlists y recargar en Kodi la biblioteca personal para
ver el nuevo archivo M3U con todos los datos.
La sintaxis para ejecutar esta herramienta es muy sencilla; simplemente hay que abrir una
lista M3U en la que delante del ttulo habremos insertado el smbolo $. As, por ejemplo si
tenemos los enlaces de unas pelculas podramos hacer el M3U de esta forma:
#EXTINF:-1,$Talk to her
http://www.allmyvideos.com/259asgZoi
#EXTINF:-1,$Die Hard
http://www.streamcloud.eu/s9aag9s86g
Al abrir esta lista se crea en la carpeta Kodi/userdata/tmp/ un archivo M3U con el mismo
nombre pero con este resultado:
#EXTINF:-1,Talk to her,tvg-logo="http://ia.mediaimdb.com/images/M/MV5BMTczNTU2NjIwOF5BMl5BanBnXkFtZTYwNzExMDg5._V1_.jpg",tvg-
10
Rev. 27.05.2016
wall="http://ia.mediaimdb.com/images/M/MV5BMTczNTU2NjIwOF5BMl5BanBnXkFtZTYwNzExMDg5._V1_.jpg",imdb=
"8",genre="Drama, Mystery, Romance",time="112 min",year="2002",dir="N/D",wri="N/D"
http://www.allmyvideos.com/aspo87
#EXTINF:-1,Die Hard,tvg-logo="http://ia.mediaimdb.com/images/M/MV5BMTY4ODM0OTc2M15BMl5BanBnXkFtZTcwNzE0MTk3OA@@._V1_.jpg
",tvg-wall="http://ia.mediaimdb.com/images/M/MV5BMTY4ODM0OTc2M15BMl5BanBnXkFtZTcwNzE0MTk3OA@@._V1_.jpg
",imdb="8.3",genre="Action, Thriller",time="131 min",year="1988",dir="N/D",wri="N/D"
http://www.allmyvideos.com/aspo87
El archivo original slo se abre como lectura, luego no se modifica nada en l. Tan solo
quedara aadir en la primera lnea del archivo M3U el modo de vista predefinido a gusto del
usuario y guardar el archivo en Kodi/userdata/playlists. Ntese que el scraper obtiene
adems el poster de la pelcula que sirve de thumbnail y fanart. Recuerda tambin que si se
vuelve a abrir la la lista M3U original no se sobreescribirn los datos de nuevo, sino que se
reescribirn al final del archivo creado en la carpeta /tmp, por lo que ten cuidado de no
duplicar entradas.
Si volvemos a abrir una lista para ejecutar el scraper, ten en cuenta que no se
borra el archivo resultante en la carpeta tmp, sino que se abre el que ya exista
con el mismo nombre y se escriben al final de la lista los nuevos ttulos
escrapeados.
11
Rev. 27.05.2016
Gua de programacin TV
Existen dos formas de ver la programacin de televisin en PalcoTV:
La primera, es mediante la herramienta EPG-TXT. Esta herramienta nos permite abrir en el
panel lateral la programacin del da de cualquier canal. Existen dos sintaxis distintas:
agendatv: Esta opcin nos permite llamar a tres parsers creados en PalcoTV para ver la
programacin: futbolenlatele, calciointv, footballonuktv y queverahora (queverdespues,
quevermastarde). Por tanto una lista se podra crear as:
#EXTINF:-1,Agenda TV de Ftbol (Espaa)
agendatv:futbolenlatele
#EXTINF:-1, Agenda TV de Ftbol (Italia)
agendatv:calciointv
#EXTINF:-1, Agenda TV de Ftbol (Reino Unido)
agendatv:footballonuktv
#EXTINF:-1,Agenda TV de deportes en general
agendatv:futbolenlatv
#EXTINF:-1,Qu ver ahora, despus, y ms tarde?
agendatv:queverahora
epg-txt: Esta segunda sintaxis nos permite mostrar la programacin diaria de un canal de
televisin. Para saber cmo escribir el canal, acudiremos a la gua de programacin de
ElPais.com de la cual obtenemos los datos y nos fijamos en la barra de direcciones del
navegador:
12
Rev. 27.05.2016
En el caso de enlaces #multi podemos aadir el smbolo arroba (@) para habilitar el EPG tanto
en la propia entrada #multi como en cualquiera de sus opciones, de forma que el EPG cargara
solo cuando hagamos clic y abramos un #multi. Veamos un ejemplo:
13
Rev. 27.05.2016
#EXTINF:-1,TELEDEPORTE
#multi
@Teledeporte HD,http://
Teledeporte (Op. 2),http://
Teledeporte (Op. 3),http://
epg-txt:teledeporte
#multi
En este ejemplo hemos habilitado el EPG pero solo se mostrar cuando hagamos clic
sobre el enlace #multi, ahorrando tiempo en la carga.
Son muy comunes estos errores a la hora de crear un #multi: No anotar el #multi de
cierre, o aadir los enlaces sin especificar el ttulo delante con el separador $.
14
Rev. 27.05.2016
#EXTM3U,contents:movies
Esta lnea se aade justo al inicio de la lista y sin saltos de lnea. La variable contents define
el tipo de contenido de la lista, pudiendo ser: Movies, TVshows, Files, Music, Albums, etc. El
modo de vista, una vez desbloqueado, permitir al usuario elegir cul es el que desee y Kodi
se encargar de memorizar el modo de vista deseado por el usuario la ltima vez que visit
esa seccin. Al margen de definir esta variable Contents es importante saber que en
funcin del tipo de enlaces que se incluya en la lista pueden haberse desbloqueado o no los
modos de vista. An en desarrollo, mientras PalcoTV da soporte a todo tipo de elementos
procurad aadir un #multi para aseguraros de desbloquear los modos de vista.
15
Rev. 27.05.2016
Imgenes y slideshows
A partir de PalcoTV 0.3.1 se aade la opcin de
crear enlaces a imgenes en las listas M3U, muy
til por ejemplo para mostrar informacin de
video. Estas imgenes no se descargan y su
sintaxis es muy sencilla:
#EXTINF:-1,Ejemplo de imagen
img:http://www.tinypic.com/25aw521.jpg
A la derecha tenis los atajos de teclado para la
manipulacin de imgenes
Archivos de texto
A partir de PalcoTV 0.3.2 se aadi la opcin de mostrar en un panel lateral que se abre por
la derecha de la pantalla el contenido de un archivo de texto indicando su ruta completa. El
archivo se descarga en la carpeta temporal. Os voy a poner dos ejemplos segn tengis
alojado el texto en una nube o en modo local.
#EXTINF:-1,Ejemplo de texto
txt:http://pastebin.com/raw.php?id=s9gSH_Z
#EXTINF:-1,Ejemplo de texto
txt:C:/Users/Usuario/Documentos/info.txt
16
Rev. 27.05.2016
Por tanto, lo ideal es que estas imgenes guarden relacin con el contenido de la
lista o su creador.
Veamos un ejemplo de cmo sera la sintaxis:
#EXTM3U,view:tvshows,logo=http://www.misimagenes.com/imagen1.jpg,background=htt
p://www.misimagenes.com/imagen2.jpg
#EXTINF:-1,Prueba 1 (se mostrar el logo y background)
http://www.unenlace.com
#EXTINF:-1,Prueba 2 (Aqu se mostrar solo el background porque el logo ya se define en esta
entrada),tvg-logo=http://.../imagen.png
http://www.unenlace.com
En este ejemplo aparecer el logo y background si activamos el elemento Prueba 1 porque
no se ha definido ninguna imagen para ese elemento. Para Prueba 2 solo aparecer el
background porque s se ha definido un thumbnail para esa entrada.
17
Rev. 27.05.2016
La sintaxis es:
#EXTINF:-1,Ttulo del vdeo 1
#multi
Opcin 1,serie:http://series.mu/235a9sw8
Opcin 2,serie:http://www.series.com/astq25q
Opcin 3,serie:http://www.series.com/2958asg
Opcin 4,Bum+
#multi
BUM+ se carga con el modo de vista Biglist para mostrar todo el ttulo de cada resultado
18
Rev. 27.05.2016
19
Rev. 27.05.2016
A partir de la versin 0.3.5 la imagen de ayuda que muestra una tabla de atajos de teclado
(rotacin, zoom, etc) aparecer solamente en la galera de cmics. Al abrir un CBR/CBZ se
inserta al inicio la opcin slideshow para mostrar todas las imgenes en transicin de
movimiento.
Los archivos CBR/CBZ se guardan en la ruta Kodi/userdata/tmp, mientras que las imgenes
que sirven de thumbnail a cada archivo CBR/CBZ en la galera de cmics se debern alojar en
Kodi/userdata/playlists. Estas imgenes son opcionales y debern tener extensin PNG.
20
Rev. 27.05.2016
Veamos un ejemplo:
#EXTINF:-1,Ttulo de prueba,tvg-logo="...",tvg-wall="...",sinopsis="Este texto es la sinopsis o
descripcin del lbum de imgenes. Podrs exceder del ancho de pantalla porque Kodi
permite deslizar el scroll para mostrar todo el texto".
cbr:https://copy.com/26lkjaslkgja
En el skin por defecto con el que se publica PalcoTV la galera de cmics se encuentra en Mi
biblioteca Mis lbumes (CBR/CBZ), sin perjuicio de que uno se cree su propio skin y
conociendo el comando de PalcoTV a ejecutar coloque esta galera donde desee.
21
Rev. 27.05.2016
Listas de pelculas
A partir de PalcoTV 0.3.3 se decidi apostar muy fuerte por las listas de pelculas. Se han
centrado los esfuerzos en cuatro pilares bsicos para una buena coleccin de pelculas:
Filtros, opciones de visualizacin, herramientas del men contextual, y evidentemente, los
regex de pelculas.
Filtros de pelculas
Partiendo de una lista de pelculas, un filtro nos va a permitir establecer un criterio
determinante para que una pelcula se muestre. Veamos unos ejemplos:
#EXTINF:-1,Filtro por ao
filtro_year:2014,http://.../url_lista_pelis.m3u
#EXTINF:-1,Pelis de Ciencia ficcin
filtro_gen:ciencia ficcin,http://.../url_lista_pelis.m3u
#EXTINF:-1,Pelis de Scarlett Johansson
filtro_cast:Scarlett Johansson,http://.../url_lista_pelis.m3u
#EXTINF:-1,Pelculas de Hitchcock
filtro_dir:Hitchcock,http://.../url_lista_pelis.m3u
22
Rev. 27.05.2016
Con el modo Biglist podemos ver mejor las etiquetas opcionales que se aaden al ttulo
23
Rev. 27.05.2016
Opciones de visualizacin
Activando previamente los filtros, el usuario podr seleccionar el modo de vista, el color de
los ttulos de las pelculas o de las etiquetas de metadatos (ao, gnero, director, etc.) Al
activar el filtro se muestran los metadatos para que el usuario elija cules mostrar en los
filtros.
24
Rev. 27.05.2016
Wikipeli (Filmaffinity)
Esta herramienta conecta con Filmaffinity y obtiene la informacin tcnica, artstica, sinopsis
y un breve nmero de las crticas ms valoradas (sin spoilers) de una pelcula, se almacena en
un archivo de texto que se guarda en la carpeta temporal (userdata/playlists/temp/) y se
muestra en el panel lateral al igual que un archivo de texto.
Hay que sealar que la puntuacin que el scraper de pelculas obtiene es el de la pgina
themoviedb.org, mientras que la puntuacin que obtenemos de esta herramienta es la de los
usuarios de Filmaffinity.
Como esta herramienta tiene un comportamiento idntico al scraper de pelculas, es muy
posible que en un futuro muy prximo se implemente en el scraper la opcin de utilizar esta
pgina para obtener los datos.
Triler de Youtube
Esta herramienta conecta con la API de Youtube para obtener el triler de la pelcula. Para
que funcione correctamente recuerda que el ttulo de la entrada debe ser el ttulo correcto
de la pelcula. El add-on de Youtube mostrar inmediatamente el triler con la mxima
calidad posible de acuerdo a la bsqueda realizada.
25
Rev. 27.05.2016
26
Rev. 27.05.2016
formato TTxCC), Sinopsis, Fecha de estreno (premiere), Cadena de televisin que lo produjo,
Poster, Fanart (fondo), y Banner (logo ancho). A esta informacin se le ha aadido los
parmetros vistos/no vistos que en PalcoTV asociaremos con la gestin y marcaje de captulos
vistos, an en desarrollo.
El funcionamiento del scraper es muy intuitivo: En la pgina principal tenemos dos opciones
para comenzar: Buscar pelcula y Buscar serie Debajo, tenemos dos listas con extensin
M3U. Estas listas estn alojadas en kodi/userdata/tmp/*.m3u y son nuestras listas de trabajo,
una para pelculas y la otra para series.
A la hora de realizar una bsqueda, se nos mostrar una lista de resultados, de forma que si
pulsamos como si fusemos a reproducir la peli o serie nos aparecer un mensaje de
confirmacin de que se ha aadido la pelcula, con sus enlaces en el caso de ser un #multi, a
la lista de trabajo.
Abriendo una de stas listas de pelis o series, se nos listar todas las pelculas guardadas con
toda la informacin, pudiendo trabajar con el men contextual (botn derecho o botn return
en el mando a distancia) para trabajar con la lista; eliminando algn elemento o todos,
recargando la lista o exportndola a la carpeta playlists con el resto de listas M3U locales.
Para habilitar ScraperX para series recuerda que debes introducir la API_Key en el
men de configuracin de PalcoTV. La API_Key se facilita al crear una cuenta en
TVDB.org o bien consultar en el foro de PalcoTV.
27
Rev. 27.05.2016
Al ser una herramienta puramente visual, cuando hagamos una bsqueda de una serie o
pelcula podremos elegir la que estamos buscando si el ttulo es un poco ambiguo y puede
corresponder a varios ttulos distintos.
Cualquier duda que tengas sobre cmo funciona plantala en el foro para detectar
posibles bugs, as como cualquier idea o sugerencia para mejorar esta herramienta.
Las actualizaciones pueden ser modulares o integrales. Una actualizacin modular implica
simplemente sobreescribir un mdulo, que puede ser un linker, un conector multimedia, el
men de configuracin o un mdulo EPG. Mientras que una actualizacin integral implica
descargar un paquete zip con la ltima versin de un add-on y reescribirlo por completo.
El Updater trabaja en modo invisible integrndose cmodamente en cualquier skin
personalizado, de forma que al entrar en PalcoTV comprobar si existen actualizaciones y solo
si existen, mostrar la entrada Actualizaciones y entre parntesis, cuntos mdulos nuevos
hay disponibles para instalar.
28
Rev. 27.05.2016
Crditos
PalcoTV es un proyecto libre basado en la colaboracin y sin nimo de lucro. Su autor disfruta
programando y compartiendo sus avances en el aprendizaje de Python sin ningn inters ms
que la satisfaccin personal. PalcoTV no comparte ningn enlace a obras protegidas por
derechos de autor; el usuario asume su propia responsabilidad al utilizar este addon.
La distribucin de PalcoTV con listas y enlaces o con nimo de lucro est perseguida por las
leyes (Reforma de la Ley de Propiedad Intelectual en Espaa, que entr en vigor el 1 de enero
de 2015). Su publicacin en Internet eximir al autor de PalcoTV de cualquier responsabilidad
recayendo nica y exclusivamente en el uploader o persona que lo distribuye pblicamente,
haya o no lucro econmico.
Agradecimientos
Al PalcoTV Team, mis fieles colaboradores y amigos: Reig, DMO, Quequino, DaniC,
Aquilesserr, MadQuark, V1k1ng0, Sebas y Paco.
A Jess, de pelisalacarta, por sus tutoriales de programacin en mimediacenter.info, y a
todos los usuarios de PalcoTV, muchas gracias por llenarme de ilusin para seguir adelante.
29