Mi media center » pelisalacarta

Guía de desarrollo de pelisalacarta: Componentes internos del plugin

Jesus — Mon, 25 Apr 2011 23:17:47 +0000

Esta entrada forma parte de una serie.

Puedes leer la entrada anterior de la serie en “Cómo funciona la actualización automática”

Si te interesa no te pierdas la sección guías de desarrollo

Hacer un plugin de XBMC es muy sencillo, lo que queda patente si echamos un vistazo al escaso número de líneas de código de algunos de los plugins más populares. Otra cosa es que la documentación que hay es escasa, y no muy buena.

Para simplificar el desarrollo de canales en pelisalacarta añadí en las primeras versiones algunos módulos comunes, recogiendo operaciones básicas como la descarga de páginas o la actualización automática. De esta forma me evitaba tener que pensar en resolver problemas comunes, y de paso simplificaba la vida a los colaboradores en el desarrollo.

Ahora en la nueva rama 3.X para no liarse mucho con el funcionamiento en cada plataforma he agrupado un poco mejor los elementos.

El paquete “core”

En esta nueva versión los módulos independientes de la plataforma se han agrupado todos en un paquete “core”, para organizar el código fuente y simplificar las dependencias entre módulos.

Podemos encontrar módulos para resolver muchas de las necesidades básicas de pelisalacarta:

config: Permite leer parámetros de configuración de forma independiente de la plataforma donde se ejecuta el plugin. La magia consiste en identificar en qué plataforma está corriendo y abrir el módulo “config” apropiado en el paquete “platform”. No funciona mal, aunque a medida que se van añadiendo plataformas la cosa se complica.
logger: Un sistema sencillo para escribir información de depuración, pero que sorprendentemente también cambia mucho de una plataforma a otra.
downloadtools: Herramientas para descargar los ficheros, algo que en Python no está realmente bien resuelto. Este módulo tiene también funciones auxiliares interesantes para tratar el encoding.
library: La aportación de Jurrabi para añadir series a la biblioteca de XBMC.
samba: Un wrapper sobre smb/nmb, dos librerías de Python para tratar la conectividad con carpetas compartidas de Windows.
updater: Verifica cada vez que inicias el plugin si hay nuevas versiones, y en caso afirmativo las descarga. La descompresión del ZIP se hace con el módulo ziptools, cuyo códig saqué buscándolo en Google
xbmctools: Es donde está el menú que sale cuando eliges una película. Ha crecido tanto que hay que reescribirlo, no es un buen ejemplo de programación en Python
scrapertools: Básicamente está todo lo necesario para la descarga de las páginas, se encarga de cosas tan exóticas como cambiar las cabeceras, gestionar las cookies, envios POST/GET, etc. Todo lo necesario para hacer creer a los sitios que en realidad XBMC es un navegador estándar.

El paquete “pelisalacarta/channels”

Contiene un módulo Python (un fichero .py) para cada canal y un ficheros xml asociado a cada uno de ellos para la actualización automática individual. Se llama así en lugar de llamarse simplemente “channels” con la idea de que algún día pelisalacarta, tvalacarta y otros plugins podrían llegar a ocupar la misma base de código fuente.

El paquete “platform”

La capacidad multiplataforma de pelisalacarta se basa en dos aspectos:

Python: Es un lenguaje interpretado, que funciona en todas las plataformas gracias a que hay un intérprte para prácticamente cualquier sistema. Además es fácilmente empotrable dentro de otras aplicaciones, lo que lo convierte en una elección muy popular para hacer extensiones de sistemas existentes.

El paquete estándar “platform” que proporciona al plugin funciones comunes de forma que no es necesario conocer su implementación específica en cada plataforma.

Hay un directorio para cada plataforma, que es ejecutado de forma selectiva desde diferentes puntos del plugin, y que proporciona:

Programa principal: Es aquí donde se almacena el punto inicial de ejecución.
Configuración: Es donde de verdad se implementa el acceso a los parámetros de configuración, traducciones y a parámetros genéricos. Es importante especialmente la función “get_data_path” para obtener una ruta donde poder escribir ficheros, y la función “get_runtime_path” para saber cual es la ruta principal del plugin.
Logging: Desde un simple “print” en unas plataformas, hasta sistemas más exóticos como el de XBMC o Plex.

El paquete “server”

Este paquete ya estaba en versiones anteriores, y agrupa los conectores de los diferentes servidores. Es aquí donde está el importante módulo “servertools” que se encarga de la detección de vídeos en una página: Basta con que le des una cadena con una página HTML y te devuelve un listado de los vídeos que encuentra incluyendo además en qué servidor están alojados.

El directorio “resources”

Además de recoger las imágenes como en versiones anteriores, en este directorio se almacenan ahora los ficheros adicionales requeridos por las diferentes plataformas. Es como el cuarto trastero

El script build.xml

Un script de ANT se encarga de empaquetar pelisalacarta en cada una de sus versiones. Esto simplifica mucho el trabajo a la hora de preparar las distribuciones más habituales (xbmc), y hace posible el empaquetado de las versiones más exóticas como la de Plex Media Server, que tiene una estructura de directorios muy peculiar. Y aún queda trabajo para perfeccionarlo.

Guía de desarrollo de pelisalacarta: Cómo funciona la actualización automática

Jesus — Sat, 23 Apr 2011 23:00:53 +0000

Esta entrada forma parte de una serie.

Puedes leer la entrada anterior de la serie en “Análisis de un canal multiplataforma”

Puedes leer la entrada siguiente en “Componentes internos del plugin”

Si te interesa no te pierdas la sección guías de desarrollo

Pelisalacarta 3.0 incorpora un mecanismo que permite a cualquier colaborador con acceso al SVN actualizar un canal que ha dejado de funcionar, o incluso modificar la lista de canales para añadir canales nuevos o quitar los que no funcionen.

El mecanismo es muy sencillo, y se basa en que hay un fichero junto a cada canal que identifica el número de versión. Si tienes un canal versión “2″ en tu pelisalacarta y alguien sube un canal con versión “3″, el plugin lo descarga y actualiza automáticamente.

Por supuesto esto sólo es posible si el usuario ha marcado esta opción entre los parámetros de configuración del plugin.

Actualizar un canal

Supongamos que queremos arreglar un fallo en cinetube, porque algún cambio en la página ha hecho que deje de funcionar o simplemente porque queremos añadir alguna mejora. Los pasos que hay que dar son sencillos:

Abrir el fichero cinetube.py y hacer las modificaciones
Subirlo el fichero cinetube.py al Subversion antes de publicar cualquier cambio
Abrir el fichero cinetube.xml e incrementar el número de versión. No hay versiones parciales, es un simple contador. Opcionalmente puede ponerse la descripción del cambio realizado, aunque actualmente no se utiliza. Si no hay fichero xml asociado al canal será necesario crearlo, poniendo como indicador de versión el “1″.
Subir el fichero cinetube.xml al Subversion. En este momento estará disponible para que todo el mundo se lo descargue.

Añadir un canal

Si lo que quieres es añadir un canal, el proceso es el mismo pero tienes que incrementar la versión de la lista de canales:

Crear el fichero .py del canal y grabarlo en el directorio “pelisalacarta/channels”.
Modificar el fichero channelselector.py para añadir el canal, indicando si es genérico o no. Si es un canal nuevo inclúyelo también en el apartado de “últimos canales”.
Subir el fichero channelselector.py al Subversion antes de publicar.
Modificar el fichero channelselector.xml para incrementar el número de la versión.
Subirlo al Subversion. En este momento estará disponible para todo el mundo.
Cuando un pelisalacarta vea que hay una nueva versión de la lista de canales se la descargará, y cuando el usuario elija el nuevo canal se lo descargará igualmente.

Eliminar un canal

Si bien es algo excepcional, también es posible eliminar canales que ya no van a funcionar de la lista de canales.

Modificar el fichero channelselector.py y comentar el canal que no funciona
Subir el fichero channelselector.py al Subversion.
Modificar el fichero channelselector.xml para incrementar el número de la versión.
Subirlo al Subversion.

Guía de desarrollo de pelisalacarta: Análisis de un canal multiplataforma

Jesus — Tue, 05 Apr 2011 23:57:17 +0000

Esta entrada forma parte de una serie.

Puedes leer la entrada anterior de la serie en “Cómo hacer canales multiplataforma”

Puedes leer la entrada siguiente de la serie en “Cómo funciona la actualización automática”

Si te interesa no te pierdas la sección guías de desarrollo

Para comprender mejor como funciona por dentro un canal multiplataforma en pelisalacarta, vamos a analizar paso a paso uno de los sencillos. He elegido el canal “seriematic”, una web de series con una estructura muy limpia que se refleja claramente en el código del módulo Python.
El canal seriematic puedes encontrarlo en esta dirección.

Cabecera

# -*- coding: utf-8 -*-
#------------------------------------------------------------
# pelisalacarta - XBMC Plugin
# Canal para seriematic
# http://blog.tvalacarta.info/plugin-xbmc/pelisalacarta/
#------------------------------------------------------------

Lo primero que te vas a encontrar es la cabecera donde se incluyen algunas líneas de comentario con la información sobre el módulo Python que estás viendo.

Es especialmente importante la primera línea, que le especifica al intérprete de Python y a los editores sobre la codificación que emplea el fichero para los caracteres internacionales. Si esta información no está indicada Python dará un error al ejecutar el módulo, y si está informada erróneamente los caracteres internacionales se mostrarán mal.

import urlparse,urllib2,urllib,re
import os, sys

A continuación se incluyen los paquetes estándar de Python más habituales, entre los que suelen encontrarse los de expresiones regulares (paquete re), manipulación de URL (urllib), así como utilidades de bajo nivel (paquetes os y sys).

try:
    from core import logger
    from core import config
    from core import scrapertools
    from core.item import Item
    from servers import servertools
except:
    # En Plex Media server lo anterior no funciona...
    from Code.core import logger
    from Code.core import config
    from Code.core import scrapertools
    from Code.core.item import Item

Los módulos del paquete “core” de pelisalacarta se encargan de las funciones comunes a todos los canales, y es donde se encuentra resuelto el problema de la multiplataforma.

Basta con que uses el módulo “logger” para escribir un log, o el módulo “config” para leer la configuración, y puedes olvidarte de cómo se resuelve cada uno de esos problemas en las diferentes plataformas.

CHANNELNAME = "seriematic"
DEBUG = True

def isGeneric():
    return True

A continuación unas pocas líneas de relleno (boilerplate code) que se ponen siempre. Una constante CHANNELNAME con el nombre del canal para simplificar el copy-paste de código entre canales, otra para usar en depuración, y la función “isGeneric” que permite identificar a este canal como multiplataforma.

Menú principal

def mainlist(item):
    logger.info("[seriematic.py] mainlist")

    itemlist = []
    itemlist.append( Item(channel=CHANNELNAME, title="Series",
      action="series", url="http://www.seriematic.com/series.php"))
    itemlist.append( Item(channel=CHANNELNAME, title="Miniseries",
      action="series", url="http://www.seriematic.com/miniseries.php"))
    itemlist.append( Item(channel=CHANNELNAME, title="Dibujos",
      action="series", url="http://www.seriematic.com/dibujos.php"))
    itemlist.append( Item(channel=CHANNELNAME, title="Anime",
      action="series", url="http://www.seriematic.com/manga.php"))

    return itemlist

El menú principal del canal se tiene que implementar en una función de nombre “mainlist”, que devuelve una lista Python con las entradas que deben mostrarse al usuario.

Cada entrada de esta lista consiste en un objeto “Item”, que es una representación más genérica del elemento “ListItem” de XBMC. En su versión más sencilla permite almacenar los valores básicos:

channel: Nombre del canal donde está la acción a realizar
action: Nombre de la función dentro del canal que realiza la acción cuando el usuario seleccione esta entrada
title: El texto que se debe mostrar en pantalla al usuario cuando se liste esta entrada
url: La URL asociada a esta entrada, si es necesario. Si la acción consiste en descargar un listado de categorías, en este atributo vendrá la URL.

Navegación

Supongamos que el usuario elige ahora la entrada titulada “Series”. Como ese item tiene la acción “series”, ese es el nombre de la siguiente función que se ejecuta en el módulo Python.

def series(item):
    logger.info("[seriematic.py] series")

    # Descarga la página
    data = scrapertools.cachePage(item.url)

    # Extrae las entradas
    patronvideos  = '([^<]+)'
    matches = re.compile(patronvideos,re.DOTALL).findall(data)
    if DEBUG: scrapertools.printMatches(matches)

    itemlist = []
    for match in matches:
        scrapedtitle = match[1]
        scrapedplot = ""
        scrapedurl = urlparse.urljoin(item.url,match[0])
        scrapedthumbnail = ""

        # Añade al listado
        itemlist.append( Item(channel=CHANNELNAME,
          action="episodios",
          title=scrapedtitle,
          url=scrapedurl ,
          thumbnail=scrapedthumbnail ,
          plot=scrapedplot ,
          folder=True) )

    return itemlist

La función recibe como parámetro el item seleccionado por si quieres utilizar la URL para descargar la página, como ocurre en este caso.

La página descargada analizada con una expresión regular para obtener los nombres de las series, y para cada coincidencia encontrada se añade un elemento a la lista de items marcando esta vez como acción “episodios”.

A su vez la acción “episodios” vuelve a hacer un procesamiento similar, pero ahora se buscan episodios de la serie elegida utilizando la URL que ha venido como parámetro.

def episodios(item):
    logger.info("[seriematic.py] episodios")

    # Descarga la página
    data = scrapertools.cachePage(item.url)

    # Extrae las entradas
    patronvideos  = '<\!-- Column 1 start -->(.*?)<\!-- Column 1 end -->'
    matches = re.compile(patronvideos,re.DOTALL).findall(data)
    if DEBUG: scrapertools.printMatches(matches)

    itemlist = []
    for elemento in matches:
        patronvideos  = '([^<]+)([^<]+)'
        patronvideos += ''
        matches2 = re.compile(patronvideos,re.DOTALL).findall(elemento)

        for match in matches2:
            scrapedtitle = match[0]+" "+match[2]
            scrapedplot = ""
            scrapedurl = urlparse.urljoin(item.url,match[1])
            scrapedthumbnail = ""

            # Añade al listado
            itemlist.append( Item(channel=CHANNELNAME,
              action="videos",
              title=scrapedtitle ,
              url=scrapedurl ,
              thumbnail=scrapedthumbnail ,
              plot=scrapedplot ,
              folder=True) )

    return itemlist

Observa que en este caso se aplican dos expresiones regulares en dos bucles “for” anidados. Esta técnica permite simplificar expresiones regulares complejas, aislando primero la zona del HTML donde está lo que te interesa para en una segunda pasada extraer los elementos.

Los vídeos

Cada entrada que devuelve la función “episodios” es un episodio de la serie, así que sólo falta recuperar las diferentes alternativas (o mirrors) de cada episodio. Esto se hace en la función “vídeos”.

def videos(item):

    logger.info("[seriematic.py] videos")

    # Descarga la página
    data = scrapertools.cachePage(item.url)

    # Extrae las entradas
    patronvideos  = '([^<]+)'
    patronvideos += ']+/>([^<]+)<'
    matches = re.compile(patronvideos,re.DOTALL).findall(data)
    if DEBUG: scrapertools.printMatches(matches)

    itemlist = []
    for match in matches:
        scrapedtitle = match[0]+" "+match[2]
        scrapedplot = ""
        scrapedurl = match[1]
        scrapedthumbnail = ""
        server="Megavideo"

        # Añade al listado
        itemlist.append( Item(channel=CHANNELNAME,
              action="play",
              title=scrapedtitle ,
              url=scrapedurl ,
              server=server , folder=False) )

    return itemlist

Esta función busca las diferentes alternativas de vídeo a reproducir, y las añade a la lista con tres diferencias básicas respecto a lo que hemos visto en el resto de casos:

server: Cada entrada es un vídeo alojado en un servidor, aunque en este canal sólo se encuentran vídeos de “Megavideo”. La URL corresponde con la de la página de Megavideo, y el parámetro server sirve para que el plugin sepa obtener el vídeo a partir de ella.
action: La acción para que el vídeo se reproduzca es “play”. No hace falta que pongas esta función, ya ha sido definida por tí para que no tengas que repetirla cada vez, aunque si añades una en el canal tendrá prioridad sobre la estándar.
folder: Estas entradas ya no tienen más navegación, así que dejan de ser “carpetas” para ser “archivos” siguiendo el símil de un sistema de ficheros.

Guía de desarrollo de pelisalacarta: Cómo hacer canales multiplataforma

Jesus — Thu, 31 Mar 2011 23:00:37 +0000

Esta entrada es la primera de una serie continuación de la serie original “Cómo añadir canales a pelisalacarta”.

Puedes leer la entrada siguiente de la serie en “Análisis de un canal multiplataforma”

Si te interesa no te pierdas la sección guías de desarrollo

La rama 3.X de pelisalacarta introduce el concepto de “canal genérico”, que a falta de un nombre mejor hace referencia a un canal que puede verse en cualquier plataforma y no sólo XBMC. Los canales genéricos se verán en WiiMC, Plex Media Server, Boxee, y en cualquier futura plataforma que soporte pelisalacarta.

Cinetube en WiiMC

Hay 5 reglas muy sencillas a seguir para desarrollar canales y que sean compatibles con cualquier plataforma. Debes desarrollar un módulo Python (un fichero .py) teniendo en cuenta:

1) Dependencia: No debe haber dependencias con módulos de XBMC o cualquier otra plataforma.
2) IsGeneric: Tienes que añadir una función “isGeneric” que devuelva “True”.
3) Mainlist: La función que muestra el primer nivel de menús debe llamarse “mainlist”, algo que no era realmente obligatorio en versiones anteriores pero ahora es necesario.
4) Item: Cada entrada del plugin se representa con un objeto de clase “Item”, que tendrá:

El título, la imagen, la descripción y un fanart opcional.
La acción que debe ejecutarse si el usuario la selecciona (el nombre de la función), junto con la URL asociada en caso de que sea necesaria.
El atributo server si la entrada corresponde a un vídeo, junto con el código del servidor donde esté alojado. Consulta la lista completa en el directorio “servers” del código.
Un atributo folder a “True” si la entrada es navegable, o “False” si es un vídeo.

5) Itemlist: Cada función deberá devolver una lista de entradas de tipo “item” que el plugin debe interpretar.

Además de ser compatible con cualquier plataforma, una ventaja adicional de los canales genéricos es que no necesitas programar tus propias funciones para las operaciones normales del plugin. En particular hay dos funciones ya implementadas, que te simplificarán mucho la vida:

findvideos: Descarga la página desde la URL que le pasas, busca todos los vídeos de todos los servidores conocidos, y devuelve un listado de entradas. Estas entradas se muestran al usuario para que elija.
play: Partiendo de la URL del vídeo que le pasas, y del servidor que has especificado, se encarga de la reproducción. Básicamente, esta función es la que muestra las opciones de “Ver”, “Descargar”, etc.

Si todo esto te suena a chino creo que con un ejemplo lo verás mejor. Pero lo veremos en la próxima entrega

Mod del skin Confluence para ver argumentos de los vídeos

Jesus — Thu, 06 May 2010 21:13:43 +0000

Si usas el skin Rapier y te gusta pelisalacarta, espero que a estas alturas ya tengas instalado el mod que publiqué hace un tiempo para poder ver el argumento de las pelis al seleccionarlas.

Si por el contrario prefieres el skin Confluence que viene por defecto con XBMC, ahora estás de suerte. El compañero Wolfk ha preparado un mod de este skin con algunos cambios interesantes.

El que más me gusta es el que permite que un vídeo seleccionado en pelisalacarta muestre el argumento sobre la carátula, de forma que se simplifica bastante el navegar entre grandes colecciones de vídeos.

Pero hay alguna mejora más:

Vistas en miniaturas en modo “biblioteca” para que el que usa banners pueda seguir viendolos
Nueva vista “Replicante”
Nueva vista “Replicante 2″ parecida a “Fanarts” pero para todas las vistas de biblioteca

Gracias a Wolfk por este regalito. Podéis descargarlo pulsando aqui, y a disfrutarlo

Como añadir canales a pelisalacarta (parte 3 y última)

Jesus — Tue, 29 Dec 2009 14:33:08 +0000

Esta entrada es parte de una serie.

Puedes leer la entrada anterior en Cómo añadir canales a pelisalacarta – Parte 2 (Paginación, menús)

Si te interesa no te pierdas la sección guías de desarrollo

Hoy vamos a darle los últimos retoques a nuestro canal para Cinegratis, que a pesar de ser el objetivo de este tutorial por no ser especialmente difícil ha resultado un canal que uso a dario porque es muy completo y con muchas opciones.

En esta última entrega vamos a añadirle algunas cosas que vienen muy bien cuando estás buscando un vídeo en pelisalacarta, además de tratar de recoger todo el contenido posible de la web. Hoy veremos:

Como añadir el buscador
Como añadir menús para el filtro por Veoh, Megavideo, Subtituladas, Latino, … y Deportes
Como terminar de arreglar series y anime
Como añadir listados por categorías para el cine, y alfabéticos para todos los canales

¿Parece mucho para una única entrega? Veréis que es realmente sencillo, puesto que sólo necesitamos una función por cada página diferente y vienen a ser todas similares.

Lo primero que vamos a hacer es añadir todas las opciones necesarias en el menú principal, usando la función “addnewfolder” que recibe como parámetro la función a ejecutar cuando se seleccione la opción, el título en pantalla y la URL de descarga en caso de ser necesario.

Nuevo menú para Cinegratis en pelisalacarta

Definición del menú en Python

Viendo el código del menú hay varias cosas interesantes que permiten hacerse mejor una idea de como funciona esto:

La opcion “Películas – Novedades” se procesa con la función “listvideos”, que utilizan también algunas de las demás opciones. Esta función interpreta las páginas que tienen listados de vídeos con carátula y descripción.
La opción “Series – Todas” se procesa con la nueva función “listsimple” que también usan algunas opciones más como veremos más abajo. Esta función interpreta las páginas que tienen listados sin carátula ni descripción.
Algunas opciones como las listas de películas por categoría, deportes, etc. tienen funciones específicas porque son diferentes del resto.
La URL (que no se ve completa en la captura) corresponde con la que sale en el navegador cuando pulsas esa opción en la página. Algunas entradas de menú, como el buscador, no la necesitan.

Para hacer el buscador añadimos la funcion “search” donde pedimos al usuario cuál es el texto a buscar usando el teclado en pantalla de XBMC. Con ese texto construimos la URL que muestra los resultados de búsqueda y se la pasamos a la funcion “listsimple” que interpreta los resultados.

Función de búsqueda

Buscador en XBMC

La función “listsimple” es similar a la que había “listvideos” pero con un patrón distinto. Cuando se selecciona un vídeo lleva a la misma función “detail”, ya que las páginas de detalle de una peli son siempre iguales.

listsimple

Con esto el buscador ya está operativo, y de paso todas las opciones de menú que usan esta función.

El listado alfabético de películas es un menú manual que tiene una entrada para cada letra, y se construye de forma similar al menú principal. No lo reproduzco aquí porque es muy sencillo, si tenéis dudas podéis mirar la función “pelisalfa” en el código.

El listado por categorías se construye extrayendo cada categoría de la página, con sus iconos y todo, y añadiendo manualmente las categorías “Versión original” y “Versión latina”.

Listado de categorías

Esta nueva función “peliscat” es algo diferente, pero tampoco es muy compleja. Utiliza un patrón para sacar las categorías, y una vez que tiene la categoría dentro del bucle for utiliza otro patrón para sacar el nombre de la categoría de la URL. Esto es necesario porque las categorías tienen icono, pero no título.

El resultado de cada categoría encontrada se añade como carpeta, con la función “listvideos” como responsable de procesar los resultados al presentarse con carátula y descripción.

Listado de películas por categoría

La sección de Deportes no es muy diferente del resto, así que si te interesa ver cómo funciona puedes descargarte el código fuente.

A modo de resumen he preparado un pequeño dibujo donde se ven todas las funciones que hay definidas en este canal de pelisalacarta, y la dependencia que tienen unas de otras.

Esquema general de todas las funciones y su dependencia

Con esto damos por concluido el post, y el tutorial de 3 partes que cuenta cómo añadir un canal a pelisalacarta. Espero que haya sido suficientemente explicativo, y que gracias a él os animéis a añadir vuestros propios canales.

El código fuente del nuevo canal está disponible aquí.

Como añadir canales a pelisalacarta (Parte 2)

Jesus — Wed, 04 Nov 2009 06:21:01 +0000

Esta entrada es parte de una serie.

Puedes leer la entrada anterior en Cómo añadir canales a pelisalacarta – Parte 1 (Un canal sencillo)

Puedes leer la entrada siguiente en Cómo añadir canales a pelisalacarta – Parte 3 (Buscador, retoques finales)

Si te interesa no te pierdas la sección guías de desarrollo

La entrega anterior de este tutorial describía cómo añadir un nuevo canal Cinegratis a pelisalacarta, pero es una web con muchas posibilidades y sólo pusimos la primera página del listado de las películas.

En esta segunda entrega vamos a ver cómo realizar algunas mejoras básicas:

1) Paginación de resultados

Para permitir avanzar entre páginas hay que añadir a la lista de resultados una carpeta “Página siguiente” que apunte a la URL de la página. Normalmente basta con buscar el botón “Siguiente” y poner la URL, pero en este caso es un poco más difícil porque no existe ese botón.

Si nos fijamos en el paginador veremos que el número de página actual está subrayado (menos mal).

Estoy en la página 6

Si buscamos en el HTML veremos que esa página está marcada con los tags y , así que ya tenemos la forma de distinguir la página.

Estoy en la página 6

Lo que hacemos es duplicar el bloque que detecta las películas, para que detecte entradas usando una expresión regular distinta. En este caso suele ser fácil ya que no necesitamos más que la URL, que volverá a apuntar además a la misma función.

El bloque que detecta la paginación

Esto añadirá el bloque de “Página siguiente” dos veces, puesto que en la web hay dos paginadores en la zonas superior e inferior de la página. Si queremos evitarlo basta con cambiar el bucle “for” por un “if” sencillo.

Sólo necesito un paginador

Para que esto funcione sólo es necesario un cambio más. En la función “mainlist” está la URL de la página de forma estática, así que aunque le pasemos la URL de la página siguiente no la va a coger. Hay que cambiar esto:

URL fija

Por esto:

URL parametrizable

Y con esto ya tenemos paginación

2) Menú para permitir elegir entre películas, series, documentales, etc.

Como la página que hemos elegido tiene muchas más opciones, la mayoría de ellas con una estructura de HTML similar, es probable que el código que ya tenemos nos sirva para ver las diferentes secciones de la web cambiando simplemente las URL. Para hacer un menú estático de este tipo, similar al que hay en otros canales de pelisalacarta, basta con copiar y pegar. Usemos como ejemplo el de Peliculasyonkis:

El menú de peliculasyonkis

Básicamente consiste en añadir a mano las carpetas, poniendo la función que debe ejecutarse, el título que quieres que tengan y la URL desde la que descargar la página con los contenidos. Algunas opciones no necesitarán URL, como el buscador, que será objeto de próximas entregas de este tutorial.

Nuestro menú sería más bien así, con las URL sacadas directamente del menú de Cinegratis:

El menú de Cinegratis

Para terminar es necesario renombrar la función “mainlist” que teníamos antes, para que pase a llamarse “listvideos”. Esto es porque la función de entrada al canal tiene que ser siempre “mainlist”, y ahora corresponde con nuestro nuevo menú.

Si entramos a probarlo veremos que funcionan bien las opciones de Películas, Estrenos y Documentales. Las de Series y Anime no van, así que probablemente el HTML de estas secciones sea distinto.

En la tercera y última entrega contaré cómo implementar el buscador de la web en el canal, además de explicar un poco más en detalle cómo funcionan las acciones y el paso de parámetros entre ellas. Esto nos permitirá montar las dos entradas de menú que faltan, y tener un menú más completo con categorías y listados alfabéticos. Eso nos dará una navegación más completa por la web.

De momento espero que lo disfrutéis. Aquí está el canal actualizado para su descarga (incluido en la próxima versión de pelisalacarta 2.8).

Y aquí van las capturas de pantalla del canal tal como ha quedado, usando el skin Rapier que últimamente me gusta cada vez más.

He modificado un poquito el skin original para que muestre el argumento de la peli seleccionada, que ayuda mucho en el plugin. Si os interesa podéis bajaros el fichero modificado aqui y sustituirlo por el vuestro dentro de skin\Rapier\720p. Pero guardaros el original, que es un experimento

Menú principal

Listado de películas con paginación

Como añadir canales a pelisalacarta (Parte 1)

Jesus — Thu, 24 Sep 2009 02:07:32 +0000

Esta entrada es la primera de una serie.

Puedes leer la entrada siguiente en Cómo añadir canales a pelisalacarta – Parte 2 (Paginación, menús)

Si te interesa no te pierdas la sección guías de desarrollo

Este es el primer post de una serie donde voy a intentar contaros lo fácil que es añadir un nuevo canal al plugin pelisalacarta para XBMC, con la intención de animar a aquellos que tengan conocimientos de programación y conseguir que entre todos haya muchas webs de contenidos en castellano en XBMC.

La estructura de ficheros del plugin es muy sencilla, y tiene los siguientes elementos:

Directorios

channels: Contiene un fichero en Python (.py) para cada canal del plugin: Cinetube, Seriesyonkis, etc.
servers: Contiene un fichero Python (.py) para cada servidor donde se alojan los vídeos: Megavideo, etc.
downloads: Es el directorio de descargas por defecto
resources/images: Donde se graban todas las imágenes del canal, iconos y demás
resources/language: Los literales traducidos en varios idiomas, grabados en un fichero xml.
resources/lib: El código común reutilizable en varios sitios.

Hay una serie de ficheros Python importantes que es necesario conocer para añadir un nuevo canal:

default.py: Es el que se ejecuta cada vez que accedes al plugin, abres una de sus carpetas o intentas ver uno de sus vídeos. No es necesario modificarlo, y básicamente lo que hace es invocar a pelisalacarta.py.

pelisalacarta.py: Extrae los parámetros más importantes de la petición y redirige al selector de canales channelselector.py.

channelselector.py: Tiene una lista manual de todos los canales activos en el plugin. Aquí es donde tenemos que añadir nuestro nuevo canal al final de la lista, usando como primer parámetro el nombre que se verá en pantalla y como segundo parámetro un nombre interno que usaremos como identificador del canal.

channels/nuevocanal.py: Este es el fichero que vamos a crear con el nuevo canal.

images/nuevocanal.png: Este es el fichero con el logotipo del canal.

¿A que parece sencillo? El primer paso es identificar una web que tenga contenido interesante, y que aloje los vídeos en uno de los servidores que pelisalacarta soporta: megavideo, tutv o stagevu. Para este tutorial vamos a coger Cinegratis.net que es una web bastante chula.

Veamos el proceso paso a paso:

1) Añadir el nuevo canal al fichero channelselector.py, al final de la lista. El primer parámetro es el nombre con que se verá el canal en la lista, el segundo es el nombre que usaremos para el thumbnail (cinegratis.png), el fichero con el canal (cinegratis.py), y en varias partes del código. El tercer parámetro es el nombre de la primera función a ejecutar dentro de cinegratis.py.

Antes

Despues

2) Hacer el thumbnail del canal como un PNG de 255×375 y grabarlo como images\cinegratis.png.

Icono de canal

3) Probar el resultado hasta ahora, entrando en el plugin a ver si sale el canal

El nuevo canal ya sale en XBMC

4) Copia uno de los ficheros de canales que hay en el directorio channels, y renómbralo a cinegratis.py. Uno sencillo que es el que vamos a usar ahora es pintadibujos.py.

5) Ábrelo con un editor y donde aparezca “pintadibujos” cámbialo por “cinegratis”

6) Cuando seleccionas el canal la primera función que se invoca es “mainlist”, donde el plugin va a la URL que le has indicado y extrae las películas para mostrarlas. Para Cinegratis la URL donde están los estrenos de las películas es http://www.cinegratis.net/index.php?module=peliculas, así que vamos a ponerla en el plugin.

Cambia la URL

Ahora viene la parte divertida, que es extraer del HTML de la página los datos de las películas. La magia se realiza gracias a las expresiones regulares y un poco de paciencia, y en realidad es muy sencillo porque apenas hay 4 trucos que resuelven la mayoría de los casoa.

Observando la página buscamos la primera película del listado:

El listado de películas

En este caso se trata de la película “Lansky (1999)”. Si le das a “Ver código fuente” en el navegador y buscas el título la encontrarás enseguida, y normalmente el resto de películas se encuentran siempre una debajo de otra en una estructura repetida. En la captura he resaltado el título, argumento, enlace a la página de detalle y carátula de la película. Veréis que al final está ya el título de la siguiente película.

HTML de la página con los elementos resaltados

La expresión regular es sencilla si deduces la estructura del código. En este caso podemos ver que el título de la película está dentro de un tag

, en el primer

, y el argumento en el siguiente

que hay. En esa misma tabla está el enlace en un tag y el thumbnail en un tag . Veamos ahora la expresión regular, que describe exactamente lo mismo con su propia notación:

La expresión regular

Es compleja, pero como todo es cuestión de práctica. Si la leemos por partes lo que significa es que el patrón que estás buscando:

“”
Empieza en la cadena “” que es el cierre del tag td.
“([^<]+)

Esta curiosa fórmula significa que a partir de ahí vale “cualquier cosa hasta encontrar el carácter <”, aunque podría haber puesto también “.*?”. Los paréntesis indican además que esa parte del texto me interesa.

Luego viene otra vez la expresión .*?, porque no interesa nada más hasta llegar al primer “
”

“
(.*?)
.*?”

Otra fórmula habitual que viene a significar hay un “
” con cosas dentro y luego un “
”. Muy normal en HTML.

Veréis que hay 4 paréntesis en la expresión regular, correspondiendo con el título (posición 0), argumento (posición 1), enlace a la página de detalle (posición 2) y thumbnail (posición 3). Con esto vamos a dar los dos últimos pasos de este tutorial.

7) Copia la expresión regular en la variable “patronvideos” tal como está en la captura.

8 ) Asigna valor a las variables que interpretan la expresión regular, utilizando el array “matches” que va a almacenar las cadenas de texto extraídas.

Asignando valores a las variables

Vamos a dejarlo por aquí ahora, con el primer listado de películas de Cinegratis que ya podéis probar.

Si entráis en una película veréis que es totalmente funciona y que podéis reproducir los vídeos, siempre que estén en alguno de los servidores soportados por el plugin (normalmente están en Megavídeo) gracias a que el mecanismo que busca los enlaces es más o menos común para todos los canales.

Aún queda mucho por hacer, como añadir la paginación y poner más listados por categorías y cosas así, que iré añadiendo en sucesivas entregas de este tutorial.

En la captura podéis ver que las pruebas las hago con XBMC en modo ventana, y el log de xbmc siempre debajo usando la utilidad BareTail para verlo en tiempo real.

El listado de películas
Puedes descargar la versión de cinegratis.py con los cambios ya realizados en este enlace.

Como usar el SVN Repo Installer de XBMC

Jesus — Mon, 17 Aug 2009 13:00:12 +0000

Tweet

Admitámoslo. El mecanismo que proporciona XBMC para instalar plugins, SVN Repo Installer, no es para usuarios inexpertos. En este post voy a intentar describir el proceso paso a paso para despejar las dudas y que todo el mundo pueda usar estos programitas.

El proceso está descrito usando el skin por defecto de XBMC (PM3HD) que todo el mundo tiene instalado. Si tienes otro skin cambia provisionalmente a este para seguir los pasos, y luego vuelves a dejar el que estaba.

Desde el menú principal, tienes que darle a la derecha y seleccionar el icono “favoritos”.

Icono "Favoritos"

Se te abrirá una ventana con el acceso al SVN Repo Installer.

Acceso al SVN Repo Installer

Al ejecutarlo te mostrará la lista de repositorios, donde puedes elegir “mimediacenter” entre otros repositorios

Lista de repositorios

Accede a la carpeta “plugins / vídeo” donde están tvalacarta y pelisalacarta. Elige el que quieras instalar y dale al botón para instalar.

Última oportunidad antes de instalar

Ahora ya te puedes ir al apartado “Vídeos” del menú de XBMC.

El menú de vídeos

Dentro de “Vídeo plugins” tendrás ya disponibles los plugins que te hayas instalado.

Acceso a plugins de vídeo

Nuevo repositorio de aplicaciones para Boxee

Jesus — Fri, 07 Aug 2009 22:31:26 +0000

Tweet

Después de varios días de pruebas he conseguido publicar un repositorio de aplicaciones para Boxee, así que se acabaron los problemas para instalar en este mediacenter las últimas versiones de tvalacarta y pelisalacarta.

La dirección del repositorio es la siguiente:

http://www.mimediacenter.info/boxee

Para los que no hayan hecho esto nunca, estos los pasos necesarios para añadir el nuevo repositorio a Boxee:

Entra en el menú “App Box” y ahí selecciona la opción “Add repository”

Añadir el repositorio

Introduce como URL http://www.mimediacenter.info/boxee, y te aparecerá el nuevo repositorio.

Nuevo repositorio añadido

Ya puedes instalar tvalacarta y pelisalacarta desde el menú “New applications”

tvalacarta entre los grandes, je je je

Si tenías las aplicaciones instaladas anteriormente, y quieres borrarlas para repetir la instalación desde el repositorio de una forma más elegante, no hay problema. Borra los directorios que creaste y luego elimina las aplicaciones de Boxee desde el menú “My applications”.