Бараг_DL

Барааг ДЛ

Простой загрузчик мультимедиа Baraag, созданный для простого способа загрузки всех изображений/видео в сообщениях, созданных учетными записями, на которые вы подписаны.

Вдохновлен PixivUtil и FantiaDL.

Большое спасибо ребятам из Mastodon.py за то, что они сделали эту реализацию намного проще, чем ожидалось.

Установка

Linux/MacOS

Рекомендуется

• Создайте среду с помощью: python3 -m venv baraag_dl

• Активируйте среду: source baraag_dl/bin/activate

• Загрузите файлы require.txt и baraag_dl.py в текущую папку.

• Установите зависимости: python3 -m pip install -r requirements.txt

• Альтернативно установите следующие пакеты с помощью python3 -m pip install :

 colorama
Mastodon.py
requests

• Запустите Baraag_DL: python3 baraag_dl.py

• После завершения работы либо закройте терминал, либо деактивируйте среду с помощью: deactivate

Опциональная дополнительная настройка

• Для дополнительного удобства я рекомендую либо создать сценарий оболочки для выполнения baraag_dl.py с использованием интерпретатора Python из среды, которую вы создали выше, либо изменить baraag_dl.py , чтобы он указывал на интерпретатор Python среды при выполнении.

• В первом случае, если мы предполагаем, что вы создали среду baraag_dl в своей домашней папке, создайте файл, содержащий следующие строки, в той же папке, что и baraag_dl.py :

 #!/bin/bash

~/baraag_dl/bin/python3 baraag_dl.py

• Сохраните файл с выбранным вами именем (в данном примере назовем его run.sh ) и предоставьте ему права на выполнение с помощью chmod +x run.sh .

• С этого момента вы сможете запускать Baraag DL, запустив run.sh без необходимости активировать или деактивировать среды.

• Для последнего измените первую строку в baraag_dl.py на #!~/baraag_dl/bin/python3

• С этого момента вы сможете запускать baraag_dl.py напрямую, без необходимости активации или деактивации среды.

• Имейте в виду, что если вы выберете последнее, вам придется повторять эту модификацию при каждом обновлении Baraag DL.

Альтернатива 1

• Пропустите виртуальную среду и установите требования базовой установки Python с помощью pip install для установки необходимых пакетов, перечисленных выше.

Альтернатива 2

• Используйте Anaconda/miniconda/miniforge, чтобы создать среду, установить необходимые пакеты и запустить baraag_dl.py из среды.

Окна

Рекомендуется

• Загрузите предварительно упакованные двоичные файлы.

Альтернатива

• Загрузите и установите Python, если он еще не установлен.

• Создайте среду с помощью: py -m venv baraag_dl

• Активируйте среду: baraag_dlScriptsactivate

• Загрузите файлы require.txt и baraag_dl.py в текущую папку.

• Установите зависимости: py -m pip install -r requirements.txt

• Альтернативно установите следующие пакеты с помощью py -m pip install :

 colorama
Mastodon.py
requests

• Запустите Baraag_DL: py baraag_dl.py

• После завершения работы либо закройте терминал, либо деактивируйте среду с помощью: deactivate

Использование

Вход в систему и аутентификация

Первый запуск

• Baraag DL зарегистрирует клиента с помощью API Mastodon, используемого Baraag.
• Это создаст постоянный токен аутентификации client_credentials в той же папке, из которой запускается baraag_dl.py.
• Вам будет предложено ввести имя пользователя (адрес электронной почты) и пароль для входа в вашу учетную запись Baraag.
• Если вход будет успешным, Baraag DL сгенерирует постоянный токен пользователя user_credentials в той же папке, из которой запускается baraag_dl.py.

Последующие запуски

• Если client_credentials и user_credentials все еще действительны, аутентификация будет происходить без ввода данных пользователем.
• Если один или оба файла станут недействительными или поврежденными, Baraag DL заново создаст клиент и снова предложит вам ввести имя пользователя и пароль.

Исполнение

• Затем вам покажут меню и спросят, как вы хотите действовать:

1. Загрузите со всех подписанных аккаунтов.

• Baraag DL автоматически:
  • Получить все аккаунты, на которые вы подписаны
  • Получить все сообщения учетных записей, на которые вы подписаны, которые содержат вложения.
  • Загрузите каждое вложение последовательно для всех отслеживаемых учетных записей.

2. Поиск конкретного пользователя

• Затем Baraag DL предложит вам ввести имя исполнителя/аккаунта для поиска.
• Если поиск окажется успешным, вам будет представлен список учетных записей, соответствующих введенному вами имени.
• Затем вы можете выбрать один из вариантов списка для учетной записи, из которой будут загружены все медиафайлы.

Загрузка и имена файлов

• Файлы сохраняются как {Date posted}_{Post ID}_{Attachment_ID}.extension в папке для каждой учетной записи, названной в формате {Account name}_{Account ID} . Имейте в виду, что Account name — это не то же самое, что Display name , поэтому общедоступное имя учетной записи и регистрационное имя Baraag могут отличаться.
• Файлы, уже загруженные и сохраненные на диске, пропускаются, чтобы сэкономить время, пропускную способность и не загружать API запросами.

️ API Mastodon ограничен 300 запросами каждые 5 минут. Это означает, что через некоторое время Baraag DL будет работать значительно медленнее, чтобы API не отключал его.

Дела

• Реализация режима пробного запуска (отладка)
• Реализовать совместимость с Pawoo.
• Скрипт установки для MacOS/Linux (?)