Skip to content
cezar-pimentelPublic
forked from katomaro/katomart

About

Esse é o melhor software para download e gerenciamento de cursos EaD que você vai ver. Coberto pelo Artigo 184 do código penal que defende a cópia de obra intelectual para uso privado do copista.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Important

AVISO: REPOSITÓRIO ARQUIVADO E PROJETO MIGRADO ⚠️

O suporte para este aplicativo foi encerrado em favor de uma versão nova e aprimorada. Este repositório foi arquivado e não receberá mais atualizações.

Por favor, utilize o novo aplicativo. A versão atualizada é um ecossistema completo que inclui recursos reais de estudo, como:

  • 📓 Cadernos
  • 📝 Bancos de Questões
  • 🗂️ Flashcards
  • 💾 Ferramentas de Backup e muito (muito) mais mesmo, além de ser bem mais estável!

✨ O novo aplicativo também pode ser utilizado de graça para downloads assim como este repositório.

🔗 Baixe a nova versão aqui: katomaro.com/store/katomart

⚠️ Por favor, não me envie e-mails ou mensagens pedindo atualizações deste repositório.⚠️

Este é provavelmente o melhor downloader de cursos EAD que você vai utilizar.

Python Telegram

Funcionalidades

Este programa vai realizar o download de cursos online que você possua acesso em diversas plataformas (ver lista atual na tabela ao fim da página). Caso você encontre problemas, busque ajuda no grupo do Telegram.


Requisitos

  • (Para executar do código fonte, recomendado para usuários Linux e Mac) Python 3.12 (Windows | Mac | Linux)
  • (Opcional, para ter uma muxagem de vídeos mais robusta) ffmpeg

Instale as ferramentas acima e adicione-as ao PATH do sistema operacional.

Uso a partir do Código Fonte

  1. Clone o repositório (ou baixe como zip):

    git clone https://github.com/katomaro/katomart.git
    cd katomart
  2. Crie e ative um ambiente virtual (JAMAIS UTILIZE AMBIENTE VIRTUAL GERADO POR TERCEIROS): Primeiramente, verifique se o Python 3.12 está instalado e qual o seu executável. Em alguns sistemas, ele pode ser chamado python3, python3.12, ou no Windows, você pode usar o py launcher.

    Para listar as versões de Python instaladas:

    # Windows
    py --list
    
    # Mac/Linux
    ls /usr/bin/python*
    # Ou, se você usa gerenciadores como o pyenv:
    pyenv versions

    Dica: python --version

    Após confirmar que o Python 3.12 está disponível, crie o ambiente virtual utilizando o executável correspondente. Substitua python3.12 pelo comando correto para o seu sistema, se necessário.

    # Se o comando for 'python3.12'
    python3.12 -m venv venv
    
    # Se estiver usando o 'py' launcher no Windows
    py -3.12 -m venv venv

    Dica: Caso tenha apenas uma versão do Python instalada (a dica anterior exibiu algo como "Python 3.12.10"), python -m venv venv

    Agora, ative o ambiente virtual:

    # Windows:
    call venv\Scripts\activate
    
    # Mac/Linux:
    source venv/bin/activate

    Após a ativação, seu terminal deverá indicar que você está no ambiente (venv) no começo do caminho do terminal, por exemplo "(venv) C:\Users\katomaro\Desktop\katomart>"

  3. Instale as dependências: Com o ambiente virtual ativado, instale as bibliotecas necessárias.

    pip install -r requirements.txt

    Dica: Em ambientes Linux ou Mac, pode ser necessário instalar o pip de forma separada, o terminal irá te apontar se for o seu caso. Também pode ser necessário o uso do comando pip3 ao invés de pip

  4. Instale o navegador do Playwright: O projeto utiliza o Playwright para automação, e é necessário instalar o navegador Chromium.

    python -m playwright install chromium
  5. Execute o projeto: Com tudo configurado, basta iniciar a aplicação.

    python main.py

Configuração

Ao abrir o programa, vá na aba Configurações no topo superior esquerdo. Descrição de cada opção

  • A sessão de autenticação no topo se refere ao seu cadastro no meu site seu cadastro no meu site, para desbloquear algumas funções adicionais, o uso do programa ainda é gratuito. // EM CONSTRUÇÃO

  • Salvar Senha do Assinante: Se ativado, a senha de login do site katomaro.com será salva no arquivo de configurações local para re-autenticação automática. A senha é armazenada em texto simples no settings.json.

  • Caminho para download: Define a pasta raiz onde as pastas dos cursos vão ser salvas. Considerar a limitação de 260 caracteres totais em caminhos de arquivos. Você pode colocar um caminho completo, inclusive de outro disco (exemplo E:\bkp\cursos), ou usar iniciar o campo com ./, que indica esta pasta, o padrão ./downloads cria uma pasta chamada downloads na pasta do programa.

  • Qualidade do Vídeo: Aqui você define a qualidade do vídeo a ser baixada. O programa sempre vai buscar a qualidade que você selecionou, se ela não existir na plataforma, ele vai baixar a próxima mais alta. Caso você selecione a mais baixa, ele vai procurar a resolução mais baixa do vídeo.

  • Tamanho máximo do nome do CURSO: Define a quantidade de caracteres máximos para o nome da pasta do curso. Por exemplo, definindo para 25, um curso com o nome Esse é um nome de curso extremamente longo e descritivo estilo redação de enem no título será salvo na pasta 25 Esse é um nome de curso e. IMPORTANTE SE LEMBRAR DO LIMITE MÁXIMO DE 260 CARACTERES CAMINHO TOTAL, o programa monta a estrutura de arquivos com {caminho de salvamento}/{Nome do Curso}/{Enumerador}. {Nome do Módulo}/{Enumerador}. {Nome da Aula}/{Enumerador}. {Nome do Arquivo}

  • Tamanho máximo do nome do MÓDULO: Ver orientações sobre o tamanho máximo do nome do CURSO

  • Tamanho máximo do nome do AULA: Ver orientações sobre o tamanho máximo do nome do CURSO

  • Tamanho máximo do nome do ARQUIVO: Ver orientações sobre o tamanho máximo do nome do CURSO. IMPORTANTE: O nome do arquivo NÃO é o nome da aula, mas sim o nome do arquivo que o produtor salvou o vídeo ou anexo. Em muitos cursos, são nomes sem sentido como M1A1.mp4

  • Timeout de Requisição: Em segundos, se o programa não obtiver uma resposta do servidor dentro do tempo definido, ele assume erro e move para a próxima aula

  • Baixar Legendas: Se ativado, o programa vai baixar as legendas do vídeo, se disponíveis.

  • Idioma das Legendas: Idioma de legenda a ser baixado, se disponível.

  • Incorporar Legendas no Vídeo: Quando as legendas são baixadas, elas ficam em um arquivo .vtt, .srt ou similares. Nem todos os players (reprodutores) de vídeo são capazes de reconhecer essas legendas (recomendo o VLC MEDIA PLAYER), ativar essa opção faz com que essas legendas sejam escritas na imagem do vídeo de forma permanente.

  • Baixar vídeos na Descrição: Se ativado, o programa vai escanear as descrições das aulas em buscas de vídeos e tentar baixar. Altamente recomendado pois existem muitos "vendedores de cursinho" que não gastam 5 minutos para aprender a usar a plataforma e colocam o vídeo no Youtube ou Vimeo e colocam o link na Descrição, ao invés de enviar o arquivo de vídeo diretamente na plataforma no campo necessário.

  • Idioma do Aúdio: Algumas raras plataformas possuem dublagens para as aulas, aqui você pode escolher o idioma a ser baixado, se disponível, na maioria das plataformas essa configuração não tem efeito.

  • Manter Apenas Aúdio: Se ativo, após baixar o vídeo, o programa vai destruir a imagem mantendo apenas o arquivo de aúdio mp3 do vídeo.

  • Baixar Podcasts: Se ativado, o programa vai baixar arquivos de áudio/podcast das aulas quando disponíveis.

  • Caminho do FFmpeg: Caminho para a pasta contendo o executável do FFmpeg (ex: ./ffmpeg/bin). O FFmpeg é usado para muxagem de vídeos, incorporação de legendas e extração de áudio. Se estiver no PATH do sistema, pode deixar vazio.

  • Baixar Widevine: REQUER CDM extraída de celular Android Se ativo, o programa vai baixar vídeos criptografados pelo Widevine. Não cobre a VDOCIPHER ou inKrypt.

  • Caminho do Bento4: Caminho para a pasta contendo o mp4decrypt do Bento4 (ex: ./bento4/bin). Necessário apenas para decriptografar conteúdo protegido por Widevine DRM.

  • Cookies do Youtube: Caminho para um arquivo Netscape com cookies autenticados do Youtube, usado para evitar bloqueios do youtube.

  • Habilitar histórico de Downloads: Quando ativo, o aplicativo vai criar um arquivo .db que armazenará o estado de tudo que for selecionado para download, na tela principal ou usando o dashboard.bat você pode abrir a interface web (WIP) para ver o estado de tudo e também iniciar a transcrição de conteúdo

  • Porta do Dashboard: Define em qual porta local a Dashboard fica hospedada

Configurações pagas (Requerem uma assinatura de 5 Reais por mês)

  • User Agent: O navegador ou dispositivo que o programa vai fingir ser para acessar o conteúdo. Não altere a menos que você saiba buscar esse valor.
  • Máximo de Downloads Concorrentes: Esse número define quantos segmentos de vídeo serão baixados de forma simultânea, isso pode drasticamente aumentar a velocidade de download, ou a diminuir. CUIDADO Não use mais de 20, muitas plataformas não toleram e isso causa várias falhas ao baixar o vídeo resultando em segmentos faltantes. O padrão para não assinantes é 1. O recomendado é 8.
  • Quantidade de Retentativas de download: Caso algum processo de obtenção de dados falhe, o número aqui define quantas vezes o programa irá tentar refazer aquele download antes de mover para o próximo. Para usuários gratuitos, a configuração é 0. Recomendado para assinantes é 5.
  • Delay para Retentativas: Quanto tempo (em segundos) o programa espera antes de tentar baixar o conteúdo novamente, aplicável apenas a assinantes, o recomendado é 60.
  • Criar JSON de Resumo: Se ativado, ao fechar o programa e abrir novamente ele irá pular toda a validação de conteúdo e usar um arquivo json criado para resumir a seleção de download anterior.
  • Caminho da CDM: Caminho para a pasta com os arquivos da CDM para decriptografar o conteúdo do Widevine.
  • Usar Proxy HTTP: Se ativado, o programa vai usar o Proxy (equivalente a VPN) para se conectar na plataforma e realizar o download. Proxies limitam a velocidade de conexão.
  • Endereço do Proxy: Endereço de conexão do proxy.
  • Nome de usuário do Proxy: Seu nome de usuário no serviço de proxy
  • Senha do Proxy: Sua senha para o Proxy
  • Porta do Proxy: A porta de conexão do Proxy
  • Usar o Whisper para Transcrição: Se ativado, usará o OpenAI Whisper para criar um arquivo de texto para cada vídeo baixado.
  • Modelo do Whisper: Define o modelo do Whisper a ser usado para transcrição, consequentemente afetando a velocidade de processamento e precisão.
  • Idioma do Whisper: Se forçado, irá tentar reconhecer o aúdio como aquele idioma.
  • Formato da Transcrição: O formato do arquivo de texto com a transcrição do conteúdo, suporta TXT, formatos de legendas, etc.
  • Transcrição em Paralelo: Se ativado, a transcrição via Whisper ocorre em paralelo ao download, sem bloquear o progresso dos downloads seguintes. Caso desativado, o programa aguarda a transcrição de cada vídeo terminar antes de prosseguir.
  • Domínios ignorados para Embed: Cada linha porta 1 domínio, esta lista é utilizada junto com a configuração gratuita de baixar vídeos na descrição, os domínios listados aqui são ignorados por completo, incluindo para retentativas futuras, o que pode acelerar bastante o download.
  • Executar FFmpeg após Download: Se ativado, o programa vai executar o FFmpeg em cada vídeo baixado usando os argumentos configurados. Útil para remuxar vídeos ou aplicar filtros customizados.
  • Argumentos do FFmpeg: Argumentos passados ao FFmpeg quando a opção acima está ativa. O padrão -c copy apenas copia os streams sem recodificar. Exemplo para comprimir: -c:v libx264 -crf 23 -c:a aac.
  • Re-autenticar em Erro: Se ativado, quando o programa receber erros de autenticação (401/400), ele tentará re-autenticar automaticamente usando as credenciais salvas antes de falhar.
  • Deletar Pasta em Erro: Se ativado, quando ocorrer um erro ao baixar uma aula, a pasta da aula será deletada. Útil para evitar pastas vazias ou incompletas.
  • Extensões de Anexos Permitidas: Lista de extensões de arquivo permitidas para download de anexos (ex: pdf,docx,xlsx). Se vazio, todas as extensões são permitidas.
  • Delay entre Aulas: Tempo de espera (em segundos) entre o download de cada aula. Útil para evitar rate-limiting em plataformas que bloqueiam acessos muito rápidos. Use valores como 5-30 segundos para plataformas sensíveis. 0 para esperar o tempo do video.
  • Comportamento de Marcar Aula: Define se o programa deve marcar as aulas como assistidas ou não assistidas na plataforma após o download. Opções: none (não altera), watched (marca como assistida), unwatched (marca como não assistida).
  • Tentar Manter Nome Original dos Vídeos: Se ativado, o programa tenta usar o nome original do arquivo de vídeo (conforme salvo pelo produtor na plataforma) ao invés de usar o nome da aula, mantendo o enumerador no início. Normalmente os nomes sao coisas nada a ver para o produtor se localizar apenas, nem sempre funciona bem, e pode causar diversos problemas por tamanho de caminho.
  • Pular Download de Vídeos: Se ativado, o programa não baixará os vídeos das aulas, apenas descrições e anexos. Útil para baixar apenas materiais complementares.
  • Não Salvar Descrições das Aulas: Se ativado, o programa não salvará os textos de descrição das aulas em arquivos separados.
  • Não Salvar Links Extras (URLs Auxiliares): Se ativado, o programa não salvará URLs auxiliares encontradas nas aulas.
  • Não Baixar Anexos: Se ativado, o programa não baixará nenhum anexo das aulas. Sobrescreve a configuração de whitelist de extensões permitidas.
  • Pular Arquivos Já Baixados: Se ativado, o programa verifica se o arquivo já existe no disco antes de baixar. Caso exista, o download é pulado. Útil para retomar downloads interrompidos sem re-baixar conteúdo já obtido.
  • Pausar após X Aulas Parciais: Número de aulas com download parcial (incompleto) que devem ocorrer antes do programa pausar automaticamente o download. Útil para revisar problemas antes de continuar. O valor 0 desativa a pausa automática.
  • Pausar após X Erros: Número de aulas com erro de download que devem ocorrer antes do programa pausar automaticamente. O valor 0 desativa a pausa automática.

Executando o Projeto

Em ambientes Windows, basta dar dois cliques no ``run.bat`, em outras plataformas, siga a seção Uso a partir do Código Fonte.

Observações

  • Certifique-se de que todas as ferramentas externas que você optou por utilizar estejam instaladas e acessíveis pelo PATH (variável de ambiente) do sistema. O FFMPEG é altamente recomendado.
  • Para baixar conteúdos protegidos por DRM, o mp4decrypt (Bento4) é obrigatório, e se o DRM for Widevine você também deve possuir uma CDM obtida a partir de um dispositivo Android.

Plataformas Suportadas (DEPRECADO, O BOT DO TELEGRAM E O SITE VAI INFORMAR CORRETAMENTE EM BREVE)

As plataformas com notas sobre testes dependem de alguém utilizar e confirmar como foi o uso.

Plataforma Possui DRM? Tipo de DRM e dependências (Se Aplicável) Última Atualização Em testes? (Pode estar faltando algo)
Hotmart Sim Falso(Social, watermark em overlay) + Widevine, necessário ter uma CDM válida e bento4 instalado 16/11/2025 Sim, players não nativos da Hotmart e embed alternativos, e a implementação mais recente do widevine
Gran Cursos Online NÃO Não aplicável 14/04/2026 O usuário precisa limitar tamanhos máximos de caminho e adicionar esperas entre as aulas pois essa plataforma entrega conteúdo MUITO rápido. CUIDADO: POSSUEM MATERIAL GERADO POR IA EM ANEXOS DE CURSOS NOVOS
Estratégia Concursos NÃO Não aplicável 27/01/2026 Qualidade do vídeo baixado pode ser melhorada.
Estratégia Concursos (LDI, livro digital interativo) NÃO Não aplicável 27/01/2026 O conteúdo é bem bagunçado mesmo, é o que eu tenho a falar, ele é um livro digital que possui seus placeholders, foge totalmente do modo de módulo/aula padronizado. A pesquisa vai mostrar capitulos tambem.
Estratégia Militares NAO Nao aplicavel 23/02/2026 Mesmas notas sobre a LDI
Estratégia Medicina NÃO Não aplicável 16/03/2026 Mesmas notas sobre a LDI
Astronmembers NÃO Não aplicável 01/08/2025 Sim, foi portado de um script standalone para o modelo novo, pode precisar de correções
Curseduca NÃO Não aplicável 06/02/2026 Sim, existem tipos de aula não mapeados
Medway NÃO Não aplicável 17/09/2025 Sim, foi portado de um script standalone para o modelo novo, pode precisar de correções
Kiwify NÃO Não aplicável 04/01/2026 Sim, pode possuir players desconhecidos
Eduzz (Nutror) SIM PandaVideo e SafeVideo, podem possuir DRM social na imagem por marca d'agua, e em casos raros, widevine que necessita de cdm e bento4 instalado 24/04/2026 Sim, com toda certeza possui tipos de aula não mapeados
Kirvano SIM PandaVideo, pode possuir DRM social na imagem por marca d'agua, e em casos raros, widevine que necessita de cdm e bento4 instalado 09/01/2026 Sim, com toda certeza possui tipos de aula não mapeados
RocketSeat Não Não aplicável, aplicam rate-limit então use delays 10/01/2026 Mais ou menos, não tem suporte a aula individual e apenas a jornadas (cursos)
AlpaClass (WhiteLabel) SIM PandaVideo, pode possuir DRM social na imagem por marca d'agua, e em casos raros, widevine que necessita de cdm e bento4 instalado, Também podem usar o Safevideo, mesmo caso anterior 10/01/2026 Tipos de aulas faltantes
TheMembers (WhiteLabel) SIM PandaVideo, pode possuir DRM social na imagem por marca d'agua, e em casos raros, widevine que necessita de cdm e bento4 instalado 19/02/2026 Podem existir tipos de players faltantes
Fluency Academy NÃO Irrelevante, usam vimeo 12/01/2026 Não localizei anexos
Data Science Academy NÃO Não aplicável 12/03/2026 Learn Worlds tecnicamente, vendo se encontro outro site usando essa base
Medcel NÃO Não aplicável 13/02/2026 Sim, recém implementada. Suporta login direto ou token.
Afya Internato NÃO Não aplicável 13/02/2026 Sim, recém implementada. Usa a mesma API do Medcel.
Área de Membros (WhiteLabel) SIM Scaleup/Smartplayer, pode possuir DRM social na imagem por marca d'agua 17/02/2026 Sim, recém implementada. Suporta login direto ou token de cookies (novo).
Udemy SIM Widevine, necessário ter uma CDM válida e bento4 instalado 21/04/2026 Sim, recém implementada. Login apenas via Playwright. Em testes de leniencia
Medcof NAO Nao aplicavel, usa Vimeo 14/02/2026 Sim, recem implementada. Importante usar delay de acesso.
Skool NAO Nao aplicavel 26/02/2026 Sim, recem implementada. Considerada em testes
Memberkit NAO Nao aplicavel 25/02/2026 Sim, recem implementada. Considerada em testes, a memberkit permite a customizacao de estilos, atualmente suporta 2 sites de ??
Green Club NAO Nao aplicavel 27/02/2026 Sim, recem implementada. Considerada em testes
Cakto NAO Nao aplicavel 27/02/2026 Sim, recem implementada. Possui duas variantes
Vompplay NAO Nao aplicavel 04/03/2026 Sim, recem implementada. Possui duas variantes. Parece ser uma variante da Greenn Club
Cademi NAO Nao aplicavel 30/04/2026 Podem ter players faltantes.
Entrega Digital NAO Nao aplicavel 01/01/2026 Podem ter players faltantes, essa plataforma tbm eh chata para usuario leigo
Matematica Pra Passar NAO Nao aplicavel 14/03/2026 Usam o youtube para hospedar videos, necessario configurar cookie de conta autenticada
Hubla NAO Nao aplicavel 17/03/2026 Plataforma nova, como sempre, pode existir conteudo desconhecido
Kajabi NAO Nao aplicavel 19/03/2026 Plataforma nova, como sempre, pode existir conteudo desconhecido
Circle SO SIM Suporta o uso de players com DRM 22/03/2026 Plataforma nova, como sempre, pode existir conteudo desconhecido
Bubble IO SIM Suporta o uso de players com DRM 29/03/2026 Plataforma nova, como sempre, pode existir conteudo desconhecido, atualmente listada como hashtag
AlfaCon (Concursos) Nao Usa apenas o player Spalla 21/04/2026 Usam recaptcha, em alguns casos podem haver bloqueios pelo google, usar delays, usar retentativas, mudar ip em ultimo caso
Projeto Caveira Nao Nao Aplicavel 20/04/2026 Plataforma a ser abstraida no futuro
FinClass NAO Nao aplicavel (DASH sem ContentProtection observado, MP4 direto disponivel) 28/04/2026 Sim, recem implementada. Educacao financeira (Thiago Nigro, Erico Rocha, etc.). Login email/senha ou sessionid.

Nota Importante: O autor é totalmente contrário ao compartilhamento de conteúdos baixados. Caso encontre alguém fazendo isso utilizando este software, não confunda as identidades; este software é aberto para qualquer pessoa utilizar.

About

Esse é o melhor software para download e gerenciamento de cursos EaD que você vai ver. Coberto pelo Artigo 184 do código penal que defende a cópia de obra intelectual para uso privado do copista.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages