Boosty Downloader

Оглавление

• Версия приложения
• Описание
• Отказ от ответственности
• Статус проекта
• Использование готовых исполняемых файлов приложения
• Использование
• Особенности
• Ограничения
• Где взять токены?
• Возможные проблемы
• В планах
• Лицензия

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

0.11.1/0.7.1

Описание

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

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

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

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

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

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

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

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

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

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

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

   

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

   • 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)

   

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

   • 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

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

1. Запустите приложение:

   cargo run --release

2. Выберите опцию в меню:
   • 1: Загрузка контента по URL поста или блога.
   • 2: Установка access token для авторизации.
   • 3: Установка refresh token и client ID.
   • 4: Очистка access token, refresh token и client ID.
   • 5: Установка лимита постов.
   • 6: Показать заголовки API клиента.
   • 7: Показать текущие настройки.
   • 8: Выход.
3. При выборе загрузки введите URL поста или блога (например, https://boosty.to/blog_name или https://boosty.to/blog_name/posts/post_id).
4. Контент сохраняется в папку с именем блога.

Особенности

• Проверка доступности 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).

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

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

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

  

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

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

  

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

  sudo apt install libwebkit2gtk-4.1-dev

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

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

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

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

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

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

В планах

• Сделать возможность автоматического извлечения аксесс и рефреш токенов из браузера.
• Расширить инструкцию по использованию приложения.

Лицензия

MIT License