README

ltv-scripts
-----------
Esdras Beleza, ltv_scripts at contato.esdrasbeleza.com


Requisitos:
- bash
- unrar
- unzip
- GNU mktemp
- Python 2.x (ainda não compatível com Python 3.x)
- Python feedparser (http://www.feedparser.org/)
- ruby

Esses scripts têm a finalidade de baixar legendas a partir do site legendas.tv.
A aplicação é feita de 3 componentes:

1. Leitor RSS
2. Script para baixar legendas
3. Script para buscar e baixar legendas baseada em uma busca

O leitor RSS acompanha o feed RSS do site legendas.tv e o processa, de acordo
com seus arquivos de configuração. O script baixa as legendas e as descomprime
num diretório.

O Script de busca recebe um comando como o informado abaixo e faz o download da legenda automagicamente. ;)

ruby legenda_downloader.rb "The Matrix"

** Esses scripts não vão rodar em sistemas Windows. **


1. Configurando
---------------

O Script Ruby usa apenas o arquivo ltv-account.cfg , que você pode configurar conforme instruções abaixo.

O leitor RSS usa 2 arquivos de configuração: ltv-account.cfg e ltv-feeds.cfg.

  1.1. ltv-account.cfg
  
        Nesse arquivo, você deve colocar seu login e senha do legendas.tv.

  1.2. ltv-feeds.cfg

     O arquivo ltv-account.cfg tem o seguinte formato:
     
        [MinhaSerieFavorita]
        name=^[N]ome[._ ]da[Ss]erie[._ ]1
        dir=/home/usuario/series/serie1
        season=1
        episode=4
        
        [OutraSerie]
        name=^[N]ome[._ ]da[Ss]erie[._ ]2
        dir=/home/usuario/series/serie2
        season=2
        episode=5

     Você precisa especificar várias seções, cada uma correspondente
     a uma série. Em cada seção, você deve colocar, no campo "name", uma
     expressão regular para verificar o nome da série, o diretório para onde
     as legendas serão descompactadas no campo "dir", e a partir de quais
     temporada e episódio iniciais o script deve baixar (campos "season" e
     "episode").


    
2. Executando
-------------

Para executar, você deve rodar o comando ./ltv-feedparser.py .
Você pode colocar esse comando na sua crontab para executar várias vezes ao dia.



3. Pendências / TODO 
--------------------

Os dois scripts estão com algumas funcionalidades pendentes. São eles:

    Leitor RSS:
      - Verificar se temos os campos necessarios no arquivo de configuração
        ltv-feeds.cfg
      - Baixar apenas as series da temporada/episodio iguais ou acima aos
        que o usuario configurou
      - Armazenar quais legendas já foram baixadas e nao baixa-las de novo
      
      
    Script para baixar e descompactar legenda:
      - Suporte a arquivos ZIP