Skip to content

ath31st/boosty_downloader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

242 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Boosty Downloader

logo.jpg

Оглавление

Версия приложения

0.13.2/0.8.3

Описание

Boosty Downloader - это portable приложение для загрузки контента (видео, изображения, текст, файлы и ссылки) с платформы Boosty. Оно поддерживает загрузку отдельных постов или всех доступных постов блога с учетом лимита. Существует в двух версиях: консольном и графическом. Обе версии поддерживают Linux и Windows.

Отказ от ответственности

Это приложение предназначено только для исследовательских и личных целей. Используя его, вы соглашаетесь:

  • Получать доступ только к вашему собственному контенту на платформе Boosty.
  • Не заниматься скрапингом, распространением или иным неправомерным использованием контента, который вам не принадлежит.
  • Соблюдать Условия использования платформы Boosty и применимые законы об авторском праве.

Статус проекта

Приложение находится в стадии активной разработки. Во время использования приложения вам могут встречаться различные ошибки. Для вывода более подробных сообщений об ошибках используйте _debug версию приложения. Пожалуйста, сообщите об этом на GitHub или в Telegram.

Функциональность приложения будут изменяться и расширяться в будущем.

Использование готовых исполняемых файлов приложения

  1. Скачайте последнюю версию приложения boosty_downloader для вашей операционной системы с релизов на GitHub.

  2. Запуск приложения

    2.1. Графическая версия (GUI)

    gui_main gui_config

    Запустите графическое приложение в зависимости от вашей системы:

    • Windows: Дважды щёлкните по файлу boosty_downloader_gui-x.x.x-windows-x86_64.exe.
    • Linux:
      1. Откройте терминал в папке с загруженным файлом.
      2. Сделайте файл исполняемым командой:
        chmod +x boosty_downloader_gui-x.x.x-linux-x86_64
      3. Запустите приложение:
        ./boosty_downloader_gui-x.x.x-linux-x86_64

    2.2. Консольная версия (CLI)

    cli

    Запустите консольное приложение в зависимости от вашей системы:

    • Windows: Дважды щёлкните по файлу boosty_downloader_cli-x.x.x-windows-x86_64.exe.
    • Linux:
      1. Откройте терминал в папке с загруженным файлом.
      2. Сделайте файл исполняемым командой:
        chmod +x boosty_downloader_cli-x.x.x-linux-x86_64
      3. Запустите приложение:
        ./boosty_downloader_cli-x.x.x-linux-x86_64

Самостоятельная сборка приложения из исходников

Требования

  • Установленный Rust.
  • Для GUI на Linux: libwebkit2gtk-4.1-dev.
    sudo apt install libwebkit2gtk-4.1-dev

Клонирование

git clone https://github.com/ath31st/boosty_downloader.git
cd boosty_downloader

Сборка

CLI версия:

cargo build --release --bin boosty_downloader_cli

GUI версия:

cargo build --release --bin boosty_downloader_gui

Запуск

Бинарники находятся в target/release/.

Linux:

./target/release/boosty_downloader_cli

Windows: Запустите target\release\boosty_downloader_cli.exe.

Особенности

  • Проверка доступности Boosty API.
  • Поддержка асинхронной загрузки с использованием tokio.
  • Прогресс-бары для отслеживания загрузки файлов.
  • Обработка ошибок с выводом в консоль (подробно в debug-версии приложения).
  • Авторизация через access token или refresh token с client ID.
  • Настраиваемое количество закачиваемых постов (по умолчанию 100).
  • Настраиваемый путь сохранения контента (по умолчанию папка с приложением).
  • Вместе с постами закачиваются комментарии и их контент.
  • Во время загрузки формируется .md файл, а потом из него .html с локальными ссылками на загруженный контент.
  • Имена постов и сохраненных папок могут не совпадать, это сделано, чтобы не ломать пути в файловой системе вашей ОС.
  • Таймаут запросов между неудачными попытками с прогрессивным увеличением.

Ограничения

  • Для загрузки платного контента необходим access token.
  • Для загрузки аудио и прикрепленных файлов так же необходим access token, даже если пост бесплатный и открытый для всех.

Где взять токены?

Залогиньтесь в Boosty (это обязательно), в браузере откройте инструменты разработчика (F12) и нажмите на вкладку "Application", затем выберите сбоку "Local Storage" и там сайт https://boosty.to. Внутри находятся различные ключи и значения, среди них вы найдете auth и _client_id. Токены копируйте без ковычек, _client_id там без ковычек. Если сразу не увидите ключ auth, то попробуйте обновить страницу (F5).

example

На примере красным выделены основные моменты, куда нажать и что там выбрать. Для основных сценариев использования достаточно одного access token (у него достаточно большая длительность). Если вы хотите автоматическое обновление токенов, то рекомендуется использовать refresh token и client ID, но они сбросят ваш текущий логин на странице Boosty и если вы там после этого перелогинитесь, то сбросите текущие токены в приложении и процесс авторизации надо будет начинать заново.

Возможные проблемы

  • Если возникнут проблемы с запуском на Windows из-за отсутствия WebView2Loader.dll.

    dll_not_found

    Скачайте архив с boosty_downloader_gui-x.x.x-windows-x86_64.zip из релиза последней версии, распакуйте и запустите приложение, там уже будет нужная библиотека WebView2Loader.

  • Если возникнут проблемы с запуском на Linux из-за необходимости установки библиотеки libwebkit2gtk-4.0-dev.

    libwebkit_no_found

    Установите библиотеку командой:

    sudo apt install libwebkit2gtk-4.1-dev

    Данная библиотека обеспечивает работу графической части приложения и позволяет сократить объем исполняемого файла до минимума.

  • В случае возникновения ошибок связанных с авторизацией - нужно обновить используемый токен в приложении (см.).

  • В вечернее время возможны проблемы с доступом к Boosty API из-за нагрузки на сервер, приложение может не стартовать из-за провала проверки доступности Boosty API. В этом случае нужно повторить попытку через 5-10 минут.

  • Не переименовывайте папки с блогами и постами, в таком случае они будут перезагружены заново.

  • Если есть подозрение, что какой-либо файл не загрузился до конца, то удалите его, он будет загружен заново. Так же можете удалять папки с постами и блогами, они будут перезагружены заново.

  • Если с проблемой не удается справиться собственными силами, то можете обратиться к разработчику на GitHub или в Telegram.

В планах

  • Расширить инструкцию по использованию приложения.

Лицензия

MIT License

About

Приложение для выгрузки контента (видео, изображения, текст, файлы и ссылки) и комментариев с платформы Boosty (бусти).

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors