Lunaris

Lunaris - локальное Flutter-приложение для просмотра booru, gelbooru, rule34-подобных источников и artist-архивов в Pinterest-стиле.

Приложение не использует отдельный backend-сервер. Вся логика живет внутри Flutter: API-провайдеры, локальный кеш metadata, избранное, коллекции, история просмотров, фильтры, диагностика, загрузки и обновления.

Возможности

• Masonry feed с несколькими провайдерами и перемешанной выдачей All providers.
• Поиск тегов через chip-input с подсказками из активных API.
• Избранное, Viewed history, коллекции и пакетное добавление в коллекции.
• Smart blacklist/whitelist по тегам, группам тегов, рейтингу, провайдеру, типу файла и score.
• Details viewer для фото, GIF, видео и SWF на Windows.
• Видеоплеер с fullscreen, repeat, mute, half-volume и сохранением настроек.
• Отдельная вкладка Artists для Kemono/Coomer без смешивания с обычным booru feed.
• Управление провайдерами, health-check и provider diagnostics.
• Кастомизация интерфейса: тема, язык, акцентный цвет, видимые вкладки, beta/experimental обновления.
• Экспорт и импорт настроек JSON.
• Автопроверка Gitea Releases, скачивание APK/Windows installer прямо из приложения.

Скачать

Готовые сборки лежат в Gitea Releases:

Lunaris 2.0.0

• Lunaris-v2.0.0.apk - APK для Android.
• LunarisSetup-v2.0.0.exe - установщик для Windows.
• LunarisPortable-v2.0.0.zip - portable-версия для Windows.

Провайдеры

Обычный feed:

• Gelbooru
• Rule34
• Safebooru
• Konachan
• Yande.re
• e621 / e926
• Xbooru
• CosBooru
• Realbooru отключен по умолчанию, если публичный API недоступен

Artists flow:

• Kemono
• Coomer

Kemono/Coomer остаются отдельным разделом Artists и не попадают в общий booru feed.

Архитектура

• lib/core - HTTP, база, кеш, ошибки, Result и утилиты.
• lib/backend/models - доменные модели.
• lib/backend/providers - API-провайдеры и ProviderManager.
• lib/backend/repositories - доступ к локальному Isar-хранилищу.
• lib/backend/services - Feed/Search/Favorites/Collections/Settings/Diagnostics/Downloads/Updates.
• lib/backend/di - Riverpod providers для backend/core.
• lib/app - приложение, роутер, тема, motion и responsive helpers.
• lib/shared/widgets - общие UI-компоненты.
• lib/features - экраны и контроллеры фич.

Запуск

flutter pub get
flutter run -d windows
flutter run -d android

Сборка

flutter analyze
flutter test
flutter build apk
flutter build windows

Windows installer собирается через Inno Setup:

ISCC.exe installer\Lunaris.iss

Как добавить провайдера

1. Создать класс, реализующий ContentProvider.
2. Добавить mapper к единой модели Post.
3. Зарегистрировать apiType в ProviderFactory.
4. Добавить seed config в ProviderRepository, если провайдер нужен по умолчанию.
5. Добавить тесты parser/provider factory.

Безопасность

• Feed работает только с metadata/preview, full file не скачивается автоматически.
• Загрузка файлов происходит только по явному действию пользователя.
• Приложение уважает API и rate limits сайтов.
• NSFW/blur/blacklist настраиваются локально.
• API keys/custom headers хранятся локально и экспортируются только через явный export settings.