CineCLI, que permite buscar filmes e executar torrents diretamente no terminal

 (github.com/eyeblech)
3 pontos por GN⁺ 2025-12-25 | 1 comentários | Compartilhar no WhatsApp
  • CineCLI é uma ferramenta CLI multiplataforma que permite buscar informações de filmes e executar torrents diretamente no terminal
  • Carrega dados de filmes por meio da API do YTS e seleciona automaticamente a melhor qualidade e seeds saudáveis
  • Foi desenvolvido com base em Python 3.11+ e oferece uma interface intuitiva usando Typer e Rich
  • Em ambientes Nix/NixOS, pode ser executado sem instalação separada, e os links magnet são enviados ao cliente de torrent padrão do sistema operacional
  • Suporta desde buscas simples por comando até o modo interativo, sendo uma ferramenta útil tanto para desenvolvedores quanto para fãs de cinema

Visão geral do CineCLI

  • CineCLI é um aplicativo CLI rápido e minimalista para explorar, verificar e executar torrents de filmes no terminal
    • Funciona em Linux, macOS e Windows
    • Oferece uma UI de terminal visualmente limpa baseada em rich
  • Usa a API do YTS para buscar informações de filmes e exibe os resultados em formato de ID, título, ano e avaliação
  • O usuário pode selecionar o ID do filme para ver detalhes e escolher o torrent desejado ou usar a função de seleção automática

Principais recursos

  • Busca de filmes: pesquisar filmes no YTS com o comando cinecli search <título>
  • Visualização de detalhes: exibe informações detalhadas do filme selecionado e a lista de torrents disponíveis
  • Seleção automática de torrent: escolhe automaticamente com base na melhor qualidade e em seeds saudáveis
  • Execução de torrent: envia o link magnet para o cliente padrão registrado no sistema operacional (qBittorrent, Transmission etc.)
  • Oferece opção de download de arquivo .torrent
  • Suporta modo interativo (interactive) para realizar passo a passo o processo de busca → seleção → download

Instalação e execução

  • Instalação via pip: 
    pip install cinecli
    • Requer Python 3.11 ou superior
  • Suporte a Nix/NixOS:
    • Com base em flake, pode ser executado sem instalar Python ou pip
    • Pode ser executado diretamente com o comando nix run github:eyeblech/cinecli
    • Pode ser adicionado ao perfil com nix profile add github:eyeblech/cinecli
  • Instalação pelo código-fonte (para desenvolvedores): 
    git clone https://github.com/eyeblech/cinecli.git
cd cinecli
pip install -e .

Exemplos de uso

  • Exemplo de busca 
    cinecli search matrix
    Exemplo de resultado: 
    ID     Title                 Year   Rating
3525   The Matrix            1999   8.7
3526   The Matrix Reloaded   2003   7.2
  • Comando para assistir ao filme 
    cinecli watch 3525
    • Exibe os detalhes do filme
    • Mostra a lista de torrents disponíveis
    • Após seleção automática ou manual, executa o magnet ou baixa o .torrent

Stack técnica

  • Baseado em Python
  • Typer: framework de CLI
  • Rich: composição da UI de terminal
  • Requests: comunicação com a API
  • YTS API: fonte de dados dos filmes

Outras informações

  • Publicado sob a licença MIT, permitindo uso e modificação livremente
  • O status da API do YTS é monitorado automaticamente a cada 15 minutos e exibido como normal (🟢) ou com falha (🔴)
  • Como projeto open source, PRs e estrelas (⭐) são bem-vindos
  • Criador: eyeblech (e-mail: 0x1123@proton.me)

Leituras relacionadas

1 comentários

 
GN⁺ 2025-12-25
Comentários do Hacker News

  • No Android TV, consegui um resultado parecido usando o Stremio(stremio.com) com o plugin Torrentio(torrentio.org)
    Seria legal se desse para fazer streaming pelo terminal também no Linux, e ficaria ainda melhor se houvesse um recurso de verificação de arquivos maliciosos antes do download

    • O Torrentio fornece os metadados, e o Stremio cuida da interface e da reprodução
      Assim, dá para manter a exigência de espaço de armazenamento no mínimo
      Fiquei me perguntando se algo parecido seria possível também no Jellyfin, e ao pesquisar vi que ele suporta arquivos .strm
      .strm é só um arquivo de texto com uma URL dentro, e consultei a documentação relacionada e a busca de issues
      Como uso tracker privado, eu teria que criar meu próprio scraper customizado para substituir a função do Torrentio, mas automatizar a geração de arquivos .strm não parece ser tão difícil
      Ainda assim, preciso verificar melhor questões de desempenho e transcoding
    • (reação curta) Shhh...

  • Dá uma sensação de estar ouvindo de novo o eco do Popcorn Time
    Se o CineCLI ficar fácil demais de usar, pode acabar atraindo avisos de copyright, mas como não parece ter reprodução direta, talvez seja um pouco mais seguro

    • O Popcorn Time foi realmente um app lendário. RIP

  • Para quem sabe usar ferramentas de CLI, não é difícil baixar releases de alta qualidade por conta própria
    Também não precisa passar por coisas como entrevista para tracker privado
    O YTS tem qualidade baixa demais, então não entendo muito bem quem é o público-alvo deste projeto — se for um projeto experimental só para testar a criação de um app em cima de uma API, faz sentido

    • Fiquei curioso para saber quais lugares valem a pena hoje em dia. A vibe do velho Napster está voltando

  • Eu também fiz algo parecido: é um webapp que pesquisa em qualquer tracker suportado pelo Jackett e faz streaming direto no navegador
    O código está aberto, então dá para ver em GitHub - rapidbay

  • Fiquei curioso sobre qual comando seria bom para instalar ou executar isso rapidamente com uv

    • Dá para rodar direto com uvx cinecli search "star wars"

  • O que eu quero é uma ferramenta que permita fazer streaming só de um trecho com timestamp específico e salvar esse trecho como arquivo local
    Se existisse algo assim, vários fluxos de trabalho ficariam muito mais eficientes

    • Se fosse possível reunir dados de pessoas baixando só trechos específicos em vez do stream inteiro, isso talvez pudesse até ser usado como argumento de fair use em torrents
    • Fiquei curioso sobre como funcionaria esse streaming por timestamp
    • Tenho a mesma dúvida — dá para fazer streaming por timestamp?

  • Terrarium TV foi o original, e depois vieram forks como Corn Time, Cinema APK, TeaTV e BeeTV

  • Isso não passa de um wrapper da API do YTS

  • Parece bem legal. Vou adicionar à minha lista de coisas para testar

  • Não consegui dizer se o GIF estava travando ou se a velocidade de digitação era realmente aquela
    Se quiser, dá até para fazer umas aulas de digitação para chegar a WPM de dois dígitos

    • Com um pouco de preparo, esse tipo de coisa pode ficar bem mais fluido
      O projeto em si é excelente, mas no vídeo de demonstração seria melhor decidir antes o que mostrar, ensaiar algumas vezes e gravar com um fluxo natural
      Fazer pequenas pausas para o espectador acompanhar tudo bem, mas digitação lenta é difícil de assistir
    • Ironicamente, no perfil do GitHub do autor tem um link para monkeytype
      Na verdade, só de aprender o básico de edição com ffmpeg já melhoraria bastante
    • Também vim aos comentários por causa daquele vídeo lento
      Não consegui ver até o fim e, por sinal, parece que também estava precisando atualizar o pip