Barag_DL

Baraag DL

Un sencillo descargador de medios de Baraag, diseñado para ser una forma sencilla de descargar todas las imágenes/videos en publicaciones realizadas por las cuentas que sigues.

Inspirado en PixivUtil y FantiaDL.

Muchas gracias a la gente de Mastodon.py por hacer que esta implementación sea mucho más fácil de lo esperado.

Instalación

Linux/Mac OS

Recomendado

• Crea un entorno con: python3 -m venv baraag_dl

• Activar el entorno: source baraag_dl/bin/activate

• Descargue requisitos.txt y baraag_dl.py a su carpeta actual.

• Instalar dependencias: python3 -m pip install -r requirements.txt

• Alternativamente, instale los siguientes paquetes usando python3 -m pip install :

 colorama
Mastodon.py
requests

• Ejecute Baraag_DL: python3 baraag_dl.py

• Después de terminar de ejecutar, cierre la terminal o desactive el entorno con: deactivate

Configuración adicional opcional

• Para mayor comodidad, recomiendo crear un script de shell para ejecutar baraag_dl.py usando el intérprete de Python del entorno que creó anteriormente, o modificar baraag_dl.py para que apunte al intérprete de Python del entorno durante la ejecución.

• Para lo primero, si suponemos que creó el entorno baraag_dl en su carpeta de inicio, cree un archivo que contenga las siguientes líneas en la misma carpeta que baraag_dl.py :

 #!/bin/bash

~/baraag_dl/bin/python3 baraag_dl.py

• Guarde el archivo con el nombre que elija (llamémoslo run.sh para este ejemplo) y concédale permisos de ejecución con chmod +x run.sh

• A partir de este momento, debería poder ejecutar Baraag DL ejecutando run.sh , sin la necesidad de activar o desactivar entornos.

• Para esto último, modifique la primera línea en baraag_dl.py a #!~/baraag_dl/bin/python3

• A partir de este momento, debería poder ejecutar baraag_dl.py directamente, sin necesidad de activar o desactivar un entorno.

• Tenga en cuenta que si elige lo último, deberá rehacer esta modificación cada vez que actualice Baraag DL.

Alternativa 1

• Omita el entorno virtual e instale los requisitos de la instalación básica de Python usando pip install para instalar los paquetes requeridos enumerados anteriormente.

Alternativa 2

• Utilice Anaconda/miniconda/miniforge para crear un entorno, instalar los paquetes necesarios y ejecutar baraag_dl.py desde el entorno.

ventanas

Recomendado

• Descargue los binarios preempaquetados.

Alternativa

• Descargue e instale Python si aún no está instalado.

• Cree un entorno con: py -m venv baraag_dl

• Activar el entorno: baraag_dlScriptsactivate

• Descargue requisitos.txt y baraag_dl.py a su carpeta actual.

• Instalar dependencias: py -m pip install -r requirements.txt

• Alternativamente, instale los siguientes paquetes usando py -m pip install :

 colorama
Mastodon.py
requests

• Ejecute Baraag_DL: py baraag_dl.py

• Después de terminar de ejecutar, cierre la terminal o desactive el entorno con: deactivate

Uso

Inicio de sesión y autenticación

Primera carrera

• Baraag DL registrará un cliente con la API Mastodon utilizada por Baraag.
• Esto generará un token de autenticación persistente, client_credentials en la misma carpeta desde la que se ejecuta baraag_dl.py.
• Se le solicitará un nombre de usuario (correo electrónico) y una contraseña para iniciar sesión en su cuenta de Baraag.
• Si el inicio de sesión es exitoso, Baraag DL generará un token de usuario persistente, user_credentials en la misma carpeta desde la que se ejecuta baraag_dl.py.

Ejecuciones posteriores

• Si client_credentials y user_credentials siguen siendo válidos, la autenticación se realizará sin la intervención del usuario.
• Si uno o ambos archivos dejan de ser válidos o se dañan, Baraag DL recreará el cliente y le solicitará nuevamente el nombre de usuario y la contraseña.

Ejecución

• Luego se le mostrará un menú y se le preguntará cómo desea continuar:

1. Descargar desde todas las cuentas seguidas

• Baraag DL automáticamente:
  • Recupera todas las cuentas que sigues
  • Obtenga todas las publicaciones de las cuentas que sigue que contengan archivos adjuntos
  • Descargue cada archivo adjunto secuencialmente para todas las cuentas seguidas

2. Busque un usuario específico

• Baraag DL luego le pedirá el nombre del artista/cuenta para buscar.
• Si la búsqueda tiene éxito, le presentará una lista de las cuentas que coinciden con el nombre que ingresó.
• Luego puede elegir entre las opciones de la lista la cuenta desde la que se descargarán todos los medios.

Descarga y nombres de archivos

• Los archivos se guardan como {Date posted}_{Post ID}_{Attachment_ID}.extension en una carpeta para cada cuenta, cuyo nombre tiene el formato {Account name}_{Account ID} . Tenga en cuenta que Account name no es lo mismo que Display name , por lo que el nombre público de una cuenta y el nombre de registro de Baraag pueden diferir.
• Los archivos ya descargados y guardados en el disco se omiten para ahorrar tiempo, ancho de banda y no bombardear la API con solicitudes.

️ La API de Mastodon está limitada a 300 solicitudes cada 5 minutos. Esto significa que Baraag DL se ejecutará considerablemente más lento después de un tiempo para evitar que la API lo corte.

Hacer

• Implementar el modo de ejecución en seco (depuración)
• Implementar compatibilidad con Pawoo.
• Instalar script para MacOS/Linux (?)