Barag_DL

Baraag DL

Un simple téléchargeur multimédia Baraag, conçu pour être un moyen simple de télécharger toutes les images/vidéos des publications publiées par les comptes que vous suivez.

Inspiré de PixivUtil et FantiaDL.

Un grand merci aux gens de Mastodon.py pour avoir rendu cette implémentation beaucoup plus facile que prévu.

Installation

Linux/MacOS

Recommandé

• Créez un environnement avec : python3 -m venv baraag_dl

• Activer l'environnement : source baraag_dl/bin/activate

• Téléchargez Requirements.txt et baraag_dl.py dans votre dossier actuel.

• Dépendances d'installation : python3 -m pip install -r requirements.txt

• Vous pouvez également installer les packages suivants à l'aide de python3 -m pip install :

 colorama
Mastodon.py
requests

• Exécutez Baraag_DL : python3 baraag_dl.py

• Une fois l'exécution terminée, fermez le terminal ou désactivez l'environnement avec : deactivate

Configuration supplémentaire facultative

• Pour plus de commodité, je recommande soit de créer un script shell pour exécuter baraag_dl.py à l'aide de l'interpréteur Python de l'environnement que vous avez créé ci-dessus, soit de modifier baraag_dl.py pour qu'il pointe vers l'interpréteur Python de l'environnement lors de l'exécution.

• Pour le premier, si nous supposons que vous avez créé l'environnement baraag_dl dans votre dossier personnel, créez un fichier contenant les lignes suivantes dans le même dossier que baraag_dl.py :

 #!/bin/bash

~/baraag_dl/bin/python3 baraag_dl.py

• Enregistrez le fichier sous le nom de votre choix (appelons- run.sh pour cet exemple) et accordez-lui les autorisations d'exécution avec chmod +x run.sh .

• À partir de ce moment, vous devriez pouvoir exécuter Baraag DL en exécutant run.sh , sans avoir besoin d'activer ou de désactiver les environnements.

• Pour ce dernier, modifiez la première ligne de baraag_dl.py en #!~/baraag_dl/bin/python3

• À partir de ce moment, vous devriez pouvoir exécuter baraag_dl.py directement, sans avoir besoin d'activer ou de désactiver un environnement.

• Sachez que si vous choisissez cette dernière solution, vous devrez refaire cette modification à chaque mise à jour de Baraag DL.

Alternative 1

• Ignorez l'environnement virtuel et installez la configuration requise pour l'installation de base de Python à l'aide pip install pour installer les packages requis répertoriés ci-dessus.

Alternative 2

• Utilisez Anaconda/miniconda/miniforge pour créer un environnement, installer les packages requis et exécuter baraag_dl.py à partir de l'environnement.

Fenêtres

Recommandé

• Téléchargez les binaires préemballés.

Alternative

• Téléchargez et installez Python s'il n'est pas déjà installé.

• Créez un environnement avec : py -m venv baraag_dl

• Activez l'environnement : baraag_dlScriptsactivate

• Téléchargez Requirements.txt et baraag_dl.py dans votre dossier actuel.

• Dépendances d'installation : py -m pip install -r requirements.txt

• Vous pouvez également installer les packages suivants à l'aide de py -m pip install :

 colorama
Mastodon.py
requests

• Exécutez Baraag_DL : py baraag_dl.py

• Une fois l'exécution terminée, fermez le terminal ou désactivez l'environnement avec : deactivate

Usage

Connexion et authentification

Première course

• Baraag DL enregistrera un client avec l'API Mastodon utilisée par Baraag.
• Cela générera un jeton d'authentification persistant, client_credentials dans le même dossier à partir duquel baraag_dl.py est exécuté.
• Vous serez invité à saisir un nom d'utilisateur (e-mail) et un mot de passe pour vous connecter à votre compte Baraag.
• Si la connexion réussit, Baraag DL générera un jeton utilisateur persistant, user_credentials dans le même dossier à partir duquel baraag_dl.py est exécuté.

Exécutions ultérieures

• Si client_credentials et user_credentials sont toujours valides, l'authentification se produira sans intervention de l'utilisateur.
• Si l'un ou les deux fichiers deviennent invalides ou corrompus, Baraag DL recréera le client et vous demandera à nouveau votre nom d'utilisateur et votre mot de passe.

Exécution

• Un menu s'affichera alors et il vous sera demandé comment vous souhaitez procéder :

1. Téléchargez depuis tous les comptes suivis

• Baraag DL va automatiquement :
  • Récupérez tous les comptes que vous suivez
  • Récupérez toutes les publications des comptes que vous suivez et qui contiennent des pièces jointes
  • Téléchargez chaque pièce jointe séquentiellement pour tous les comptes suivis

2. Rechercher un utilisateur spécifique

• Baraag DL vous demandera alors le nom de l'artiste/compte à rechercher.
• Si la recherche réussit, elle vous présentera une liste des comptes correspondant au nom que vous avez saisi.
• Vous pourrez alors choisir parmi les options de la liste le compte à partir duquel tous les médias seront téléchargés.

Téléchargement et noms de fichiers

• Les fichiers sont enregistrés sous le nom {Date posted}_{Post ID}_{Attachment_ID}.extension dans un dossier pour chaque compte, nommé au format {Account name}_{Account ID} . Gardez à l'esprit que Account name n'est pas le même que Display name , donc le nom public d'un compte et le nom d'enregistrement Baraag peuvent différer.
• Les fichiers déjà téléchargés et enregistrés sur le disque sont ignorés pour gagner du temps, de la bande passante et ne pas bombarder l'API de requêtes.

️ L'API Mastodon est limitée à 300 requêtes toutes les 5 minutes. Cela signifie que Baraag DL fonctionnera considérablement plus lentement après un certain temps afin d'éviter d'être interrompu par l'API.

Faire

• Implémenter le mode d'exécution à sec (débogage)
• Implémentez la compatibilité Pawoo.
• Script d'installation pour MacOS/Linux (?)