DownloadLib

Браузерное расширение для загрузки манги и ранобэ с MangaLib и RanobeLib

📦 Скачать · ⚠️ Сообщить об ошибке · ✏️ Участвовать в разработке

Хотите помочь проекту или узнать, что планируется в следующих версиях? Смотрите CONTRIBUTING.md.

---

О проекте

DownloadLib — расширение для браузера, позволяющее скачивать мангу с порталов MangaLib и RanobeLib в форматах FB2, EPUB, MOBI, PDF и TXT/JPEG. Поддерживает автоматическую обработку изображений и текста, гибкие настройки скорости загрузки и размеров загружаемых файлов.

---

Скриншоты

MangaLib	RanobeLib	Плагин
История	Настройки	Кнопка на сайте

---

Возможности

⬇️ Форматы загрузки	FB2, EPUB, MOBI, PDF, TXT, JPEG (ZIP)
📋 Выборочная загрузка	Загрузка определённых глав и томов произведения
⏸️ Гибкая настройка	Лимит запросов в минуту и ограничение частей файла по размеру или числу глав
🖼️ Автокадрирование	Разбиение длинных страниц манги на части для читалок
⚙️ Выбор перевода	Возможность выбрать понравившегося переводчика при имеющихся альтернативных переводах
🔗 Система плагинов	Возможность расширять список поддерживаемых сайтов и форматов
🖱️ Кнопка на сайте	Встроенная кнопка быстрого скачивания прямо на странице тайтла
🛡️ Блокировка рекламы	Автоматически скрывает рекламу на страницах тайтлов

---

Поддерживаемые браузеры

Браузер	Минимальная версия	Поддержка
Firefox	115	Полная поддержка всех функций
Chromium (Chrome, Edge, Яндекс и др.)	102	Полная поддержка всех функций
Firefox для Android	115	⚠️ Бета — некоторые функции могут работать нестабильно

Минимальные версии определяются API расширений, на которые опирается DownloadLib, прежде всего storage.session. Для Chromium-браузеров указана версия движка Chromium: у Яндекс Браузера и некоторых других браузеров своя нумерация версий.

---

Установка

Готовые сборки

1. Откройте раздел Releases.
2. Для Firefox скачайте .xpi файл последней версии.
3. Для Chromium-браузеров (Chrome, Edge, Яндекс и др.) скачайте .crx файл.

Ручная установка

Firefox

1. Клонируйте репозиторий:

   git clone https://github.com/ivanvit100/DownloadLib

2. Откройте страницу about:debugging в Firefox (версия 115 или новее).
3. Во вкладке «Этот Firefox» выберите «Загрузить временное дополнение».
4. Убедитесь, что выбран файл manifest.firefox.json (переименуйте в manifest.json).

Chromium-браузеры

1. Клонируйте репозиторий:

   git clone https://github.com/ivanvit100/DownloadLib

2. Откройте страницу chrome://extensions/ в браузере (Chromium 102 или новее).
3. Включите «Режим разработчика».
4. Нажмите «Загрузить распакованное расширение» и выберите папку проекта.
5. Убедитесь, что выбран файл manifest.chrome.json (переименуйте в manifest.json).

---

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

1. Откройте страницу манги на MangaLib или RanobeLib.
2. Кликните по иконке расширения или нажмите встроенную кнопку на сайте.
3. Выберите нужный формат — FB2, EPUB, MOBI, PDF или TXT/JPEG.
4. При необходимости задайте диапазон глав (по главам или по томам) и перевод. Лимит запросов в минуту и ограничение части файла (по размеру или по числу глав) настраиваются в настройках расширения.
5. Нажмите «Скачать книгу».

---

Технические детали

• Для PDF используется html2pdf, для EPUB и JPEG — JSZip.
• Код — нативные ES-модули без сборки; все запросы к сервису идут из его открытой вкладки.
• Ядро загрузки, сетевой слой, история и авторизация — в core/.
• Форматтеры — в exporters/.
• Адаптеры сайтов — в services/.
• UI popup и шаблоны видов — в ui/ и templates/.
• Контент-скрипты (очистка рекламы на странице, кнопка на сайте) — в content/.
• Фоновые скрипты (общий для всех окон ограничитель запросов, хранилище токенов, перехват запросов, маршрутизация сообщений, блокировка рекламных запросов) — в background/.
• Подробности — в ARCHITECTURE.md, включая контракт плагинов.
• Для Chrome/Chromium используется manifest.chrome.json и Service Worker.
• Для Firefox — manifest.firefox.json и фоновая страница.
• Покрытие тестами 100% через Vitest.

---

Благодарности

Отдельное спасибо контрибьюторам проекта:

BlackRavenoo

Dordovel

weltora

---

Другие проекты

• SoundDLib - загрузка музыки с различных сервисов

---

Обратная связь

• GitHub Issues
• Автор: ivanvit.ru

---

_{DownloadLib — ваш удобный способ сохранить любимую мангу!}