PlayWarlock

Script para descargar series y películas fácil, rápido, gratis y sin anuncios.

Instalación

Requiere python > 3.x

Clonar repositorio

git clone https://github.com/edo0xff/playwarlock.git
cd playwarlock

Instalar dependencias

python3 -m pip install -l requirements.txt

Modo de uso

Busqueda

python3 cli.py --search "juego de tronos"

o

python3 cli.py -s "hombres de negro"

Descargar

Película

python3 cli.py --download https://playwarez.cc/hombres-de-negro-3-2012/ --output "Hombres de negro 3" --output-dir /home/user/Videos

Serie completa

Paso 1. Obtener el listado de capítulos

mkdir /home/user/Videos/GoT
python3 cli.py --list-episodes https://www.serieshd.tv/serie/juego-de-tronos > /home/user/Videos/GoT/got-episodes.txt

Nota: Puedes quitar del archivo txt los episodios que no desees descargar.

Paso 2. Descarga

python3 cli.py --batch-download /home/user/Videos/GoT/got-episodes.txt --output-dir /home/user/Videos/GoT

API

API para en un futuro implementar la herramienta como una interfaz web.

python3 api_server.py

Acceder desde el navegador a la dirección http://localhost/api/v0.1

Rutas soportadas por la API:

• /api/v0.1/ Muestra info de la API
• /api/v0.1/search Realizar busqueda de series y peliculas
  • Parámetros
    • q Argumento de busqueda
  • Ejemplo
    • /api/v0.1/search?q=juego+de+tronos
• /api/v0.1/episodes Lista episodios de una serie
  • Parámetros
    • url URL de la serie
  • Ejemplo
    • /api/v0.1/episodes?url=https://playwarez.cc/series/juego-de-tronos-gratis-a/
• /api/v0.1/video_source Devuelve la dirección el archivo de origen (mp4) del episodio/película
  • Parámetros
    • url URL del episodio o película
  • Ejemplo
    • /api/v0.1/video_source?url=https://playwarez.cc/episode/juego-de-tronos-season-4-episode-8

Cómo contribuir

Añadir soporte para más páginas

• Crear la librería dentro de /libs nombrando el archivo de la librería de la siguiente manera: _paginadeseries_com.py

• Dentro crear una clase nombrada de la siguiente manera: PaginaDeSeriesCOM, la clase debe tener la siguiente estructura y métodos:

    class PaginaDeSeriesCOM:
    	def __init__(self):
    		super().__init__()
    		self.hostname = 'paginadeseries.com'
  
    	def search(self, query):
    		pass
  
    	def getEpisodes(self, url):
    		pass
  
    	def getVideoSource(self, url):
    		pass
  

• En el constructor se inicializa la propiedad hostname para indicar con que sitio web trabaja la librería, esto es importante ya que la interfaz decidirá con que libraría descargar un video con base en este parámetro, comparando la URL de la serie o película con el hostname de la librería.

• El método search recibe como parametro el termino de busqueda (no esta optimizado para usarlo en una URL), debe regresar una lista de tuplas con los resultados de la busqueda, de la siguiente forma:

    [
    	("titulo del resultado 1", "URL", "URL para imagen miniatura"),
    	("titulo del resultado 2", "URL", "URL para imagen miniatura")
    ]
  

• El método getEpisodes recibe como parametro la URL de una serie, debe retornar una lista de tuplas con los episodios de la serie, de la siguiente forma:

    [
    	("temporada 1 capitulo 1", "URL"),
    	("temporada 1 capitulo 2", "URL"),
    	("temporada 2 capitulo 1", "URL"),
    	("temporada 2 capitulo 2", "URL")
    ]
  

• El método getVideoSource recibe como parametro la URL de un episodio o de una película, este debe retornar un string con la URL al origen del video (mp4), esto se puede hacer de varias formas pero casi siempre se necesita de algo de ingeniería inversa en la página web para ver de dónde y cómo se reproducen los videos.

Finalmente añadir un objeto de la clase a la variable sites en el archivo __init__.py

Webs soportadas hasta ahora

• playwarez.cc
• serieshd.tv
• cuevana3.io
• www3.animeflv.net

ToDo

• Hacer que funcione con más páginas
• Crear un cliente web para la API

Contributors

• edo0xff