Barag_DL

Baraag DL

Um simples downloader de mídia Baraag, feito para ser uma forma simples de baixar todas as imagens/vídeos em postagens feitas por contas que você segue.

Inspirado em PixivUtil e FantiaDL.

Muito obrigado ao pessoal do Mastodon.py por tornar esta implementação muito mais fácil do que o esperado.

Instalação

Linux/Mac OS

Recomendado

• Crie um ambiente com: python3 -m venv baraag_dl

• Ative o ambiente: source baraag_dl/bin/activate

• Baixe requisitos.txt e baraag_dl.py para sua pasta atual.

• Instale dependências: python3 -m pip install -r requirements.txt

• Alternativamente, instale os seguintes pacotes usando python3 -m pip install :

 colorama
Mastodon.py
requests

• Execute Baraag_DL: python3 baraag_dl.py

• Após terminar a execução, feche o terminal ou desative o ambiente com: deactivate

Configuração adicional opcional

• Para maior comodidade, recomendo criar um script de shell para executar baraag_dl.py usando o interpretador Python do ambiente que você criou acima ou modificar baraag_dl.py para apontar para o interpretador Python do ambiente durante a execução.

• Para o primeiro caso, se supormos que você criou o ambiente baraag_dl em sua pasta pessoal, crie um arquivo contendo as seguintes linhas na mesma pasta que baraag_dl.py :

 #!/bin/bash

~/baraag_dl/bin/python3 baraag_dl.py

• Salve o arquivo com um nome de sua escolha (vamos chamá-lo de run.sh neste exemplo) e conceda-lhe permissões de execução com chmod +x run.sh .

• A partir deste ponto, você poderá executar o Baraag DL executando run.sh , sem a necessidade de ativar ou desativar ambientes.

• Para este último, modifique a primeira linha em baraag_dl.py para #!~/baraag_dl/bin/python3

• A partir deste ponto, você poderá executar baraag_dl.py diretamente, sem a necessidade de ativar ou desativar um ambiente.

• Esteja ciente de que se você escolher a última opção, precisará refazer esta modificação sempre que atualizar o Baraag DL.

Alternativa 1

• Ignore o ambiente virtual e instale os requisitos na instalação básica do Python usando pip install para instalar os pacotes necessários listados acima.

Alternativa 2

• Use Anaconda/miniconda/miniforge para criar um ambiente, instalar os pacotes necessários e executar baraag_dl.py de dentro do ambiente.

Windows

Recomendado

• Baixe os binários pré-empacotados.

Alternativa

• Baixe e instale o Python se ainda não estiver instalado.

• Crie um ambiente com: py -m venv baraag_dl

• Ative o ambiente: baraag_dlScriptsactivate

• Baixe requisitos.txt e baraag_dl.py para sua pasta atual.

• Instale dependências: py -m pip install -r requirements.txt

• Alternativamente, instale os seguintes pacotes usando py -m pip install :

 colorama
Mastodon.py
requests

• Execute Baraag_DL: py baraag_dl.py

• Após terminar a execução, feche o terminal ou desative o ambiente com: deactivate

Uso

Login e autenticação

Primeira corrida

• Baraag DL registrará um cliente na API Mastodon usada por Baraag.
• Isso irá gerar um token de autenticação persistente, client_credentials na mesma pasta em que baraag_dl.py é executado.
• Será solicitado um nome de usuário (e-mail) e senha para fazer login em sua conta Baraag.
• Caso o login seja bem-sucedido, Baraag DL gerará um token de usuário persistente, user_credentials na mesma pasta de onde baraag_dl.py é executado.

Execuções subsequentes

• Se client_credentials e user_credentials ainda forem válidos, a autenticação acontecerá sem a entrada do usuário.
• Caso um ou ambos os arquivos se tornem inválidos ou corrompidos, o Baraag DL recriará o cliente e solicitará novamente o nome de usuário e a senha.

Execução

• Em seguida, será mostrado um menu e perguntado como você gostaria de proceder:

1. Baixe de todas as contas seguidas

• Baraag DL irá automaticamente:
  • Busque todas as contas que você segue
  • Busque todas as postagens das contas que você segue que contenham anexos
  • Baixe cada anexo sequencialmente para todas as contas seguidas

2. Procure um usuário específico

• Baraag DL solicitará o nome do artista/conta a ser pesquisado.
• Se a pesquisa for bem-sucedida, será apresentada uma lista das contas que correspondem ao nome inserido.
• Você pode então escolher entre as opções da lista a conta da qual todas as mídias serão baixadas.

Download e nomes de arquivos

• Os arquivos são salvos como {Date posted}_{Post ID}_{Attachment_ID}.extension em uma pasta para cada conta, nomeada no formato {Account name}_{Account ID} . Lembre-se de que Account name não é igual ao Display name , portanto, o nome público de uma conta e o nome de registro do Baraag podem ser diferentes.
• Os arquivos já baixados e salvos em disco são ignorados para economizar tempo, largura de banda e não bombardear a API com solicitações.

️ A API Mastodon está limitada a 300 solicitações a cada 5 minutos. Isso significa que o Baraag DL será executado consideravelmente mais devagar depois de algum tempo, para evitar ser interrompido pela API.

Pendência

• Implementar o modo de simulação (depuração)
• Implemente a compatibilidade com Pawoo.
• Script de instalação para MacOS/Linux (?)