LBK Launcher

LBK Launcher — настільний застосунок, який збирає українські фанатські локалізації в одному місці й допомагає встановлювати їх без танців із бубном.

Один лаунчер. Багато команд. Ще більше ігор українською.

---

⬇️ Завантаження

Windows

⚠️ Браузер або Windows можуть заблокувати завантаження/встановлення

Попередження в браузері при завантаженні

Браузер (Chrome, Edge, Firefox) може показати попередження, що файл «не перевірено» або «може бути небезпечним». Це тому, що файл не має цифрового підпису — просто натисни «Зберегти» або «Все одно завантажити».

Попередження Windows при запуску

При спробі запустити інсталятор Windows може показати «Windows protected your PC» (Windows захистив ваш ПК) або SmartScreen заблокує запуск.

Чому це відбувається?

Microsoft вимагає, щоб програми були підписані цифровим сертифікатом (EV Code Signing Certificate коштує від $200-400/рік). LBK Launcher — безкоштовний open-source проєкт, тому ми не маємо такого сертифіката. Windows SmartScreen автоматично блокує непідписані програми, особливо якщо вони ще не набрали «репутацію» (достатню кількість завантажень).

Як запустити інсталятор?

1. У вікні попередження натисни «More info» (Докладніше)
2. Потім натисни «Run anyway» (Усе одно запустити)

Або через властивості файлу:

1. Клацни правою кнопкою миші на завантаженому файлі
2. Обери «Властивості»
3. Внизу вікна постав галочку «Розблокувати» (Unblock)
4. Натисни «OK» і запусти файл знову

Якщо увімкнено «Інтелектуальне керування програмами» (Smart App Control)

У Windows 11 може бути активована функція Smart App Control, яка повністю блокує запуск непідписаних програм без можливості обійти блокування. Щоб вимкнути її:

1. Відкрий «Безпека Windows» (Windows Security)
2. Перейди до «Керування програмами та браузером» (App & browser control)
3. Праворуч клацни «Параметри служби: Інтелектуальне керування програмами» (Smart App Control settings)
4. Обери «Вимкнути» (Off)

⚠️ Увага: Після вимкнення Smart App Control його не можна знову увімкнути без перевстановлення Windows.

macOS

Linux

📖 Встановлення через Flatpak

Найпростіший спосіб встановлення. Відкрийте посилання на flatpakref — система запропонує встановити застосунок автоматично.

Або через термінал:

flatpak install --user https://flatpak.lbklauncher.com/com.lbk.launcher.flatpakref

📖 Встановлення через AUR (Arch Linux)

Через AUR-хелпер:

yay -S lbk-launcher-bin
# або
paru -S lbk-launcher-bin

Або вручну:

git clone https://aur.archlinux.org/lbk-launcher-bin.git
cd lbk-launcher-bin
makepkg -si

Steam Deck

📖 Інструкція з встановлення на Steam Deck

Спосіб 1: Flatpak (рекомендовано)

Найпростіший спосіб — встановити через Flatpak:

1. Перейди в Desktop Mode (утримуй кнопку живлення → Switch to Desktop)
2. Відкрий Firefox і перейди за посиланням на flatpakref
3. Система автоматично відкриє Discover і запропонує встановити LBK Launcher
4. Натисни «Install» і дочекайся завершення

Або через термінал (Konsole):

flatpak install --user https://flatpak.lbklauncher.com/com.lbk.launcher.flatpakref

---

Спосіб 2: AppImage

1. Перейди в Desktop Mode (утримуй кнопку живлення → Switch to Desktop)
2. Відкрий браузер і завантаж AppImage файл з посилання вище
3. Файл з'явиться в папці ~/Downloads

Дозвіл на виконання:

1. Відкрий файловий менеджер Dolphin
2. Перейди до папки Downloads
3. Клацни правою кнопкою миші на файл LBK-Launcher-linux.AppImage
4. Обери «Properties» (Властивості)
5. Перейди на вкладку «Permissions» (Дозволи)
6. Постав галочку «Execute: Allow executing file as program» (Є виконуваним)
7. Натисни «OK»

---

Додавання до Steam (для запуску в Gaming Mode)

1. Відкрий Steam в Desktop Mode
2. Натисни «Додати гру» (Add a Game) → «Додати гру не зі Steam» (Add a Non-Steam Game)
3. Натисни «Огляд» (Browse) і знайди LBK Launcher
4. Натисни «Додати вибрані програми» (Add Selected Programs)

Налаштування контролера (опціонально) LBK Launcher підтримує навігацію геймпадом! Режим навігації ввімкнеться автоматично при натиску на любу кнопку геймпаду.

💡 Тепер можеш запускати LBK Launcher прямо з Gaming Mode!

---

📸 Скріншоти

Переглянути більше скріншотів

Світла тема — сторінка гри	Темна тема — сторінка гри
Налаштування застосунку	Центр сповіщень
Встановлена локалізація

---

🌍 Додайте свій переклад до лаунчера!

📢 Є власна локалізація? Ми чекаємо на вас!

🎯 Хочете, щоб ваші переклади побачило більше українських гравців?

✅ Додавання перекладів — безкоштовно ✅ Єдиний каталог для всіх локалізаційних команд ✅ Автоматичні оновлення для ваших користувачів

💬 ➡️ Натисніть сюди, щоб додати свій переклад ⬅️

---

🎮 Що це таке

LBK Launcher:

• показує каталог доступних локалізацій;
• вміє завантажувати й встановлювати переклади за тебе;
• може оновлювати встановлені локалізації, коли виходять нові версії;
• слугує спільним «хабом» для різних спілок.

Мета проста — зробити так, щоб шлях від «побачив переклад» до «граю українською» займав кілька кліків.

---

👥 Кому може стати в пригоді

Гравцям

• Хочеш грати українською, але не любиш копирсатися в архівах та інструкціях.
• Цінуєш, коли переклад можна поставити й оновити через одну програму.

Локалізаційним спілкам

• Потрібен зручний спосіб роздавати свої переклади гравцям.
• Хочеш, щоб проєкти твоєї команди були в спільному каталозі з іншими локалізаціями.

Авторам контенту

• Легше показувати глядачам, що саме й де встановити.
• Можна тримати весь набір локалізацій під рукою в одному інтерфейсі.

---

✨ Основні можливості

• 📂 Список ігор та локалізацій із короткими описами
• ⚡ Блискавична швидкість завдяки локальній базі даних
• ⬇️ Завантаження локалізацій без ручного пошуку файлів
• 🧩 Напівавтоматне встановлення (Steam / GOG та інші підтримувані платформи)
• 🔁 Оновлення локалізацій через лаунчер, якщо команда їх публікує
• 🔄 Realtime оновлення каталогу — нові ігри та зміни з'являються миттєво
• 📡 Працює навіть офлайн (після першого запуску)
• 📢 Нотифікації про нові релізи самого лаунчера
• 🔧 Базові налаштування шляхів до ігор (де це потрібно)

---

🧱 Технологічний стек

LBK Launcher — відкритий проєкт з відкритим вихідним кодом, побудований на сучасних інструментах:

• Electron 39 + Vite — настільний фреймворк та швидке збирання
• React 18 + TypeScript — інтерфейс користувача
• Tailwind CSS — стилі та дизайн
• Framer Motion — плавні анімації інтерфейсу
• Zustand — керування станом застосунку
• better-sqlite3 — локальна база даних для швидкої роботи офлайн
• Supabase — синхронізація даних та realtime оновлення
• electron-builder — білд та автооновлення
• Lucide React — іконки

🔄 Local-First архітектура

Лаунчер використовує local-first підхід для максимальної швидкості та надійності:

• Локальна SQLite база даних — всі ігри та метадані зберігаються локально для миттєвого доступу
• Фонова синхронізація — дані оновлюються з Supabase при запуску застосунку
• Realtime оновлення — зміни в каталозі ігор миттєво відображаються через WebSocket підписку
• Працює офлайн — можна переглядати каталог навіть без інтернету (після першого запуску)

🍎 Особливості для macOS

• Apple Silicon та Intel — нативна підтримка обох архітектур (arm64, x64)
• Liquid Glass — сучасний ефект прозорості для macOS Tahoe 26+ (можна вимкнути в налаштуваннях)
• Dark Mode — автоматична підтримка темної теми системи
• DMG-інсталятор — простий drag & drop для встановлення

---

🚀 Як розпочати (користувачам)

1. Перейди до розділу Releases цього репозиторію.
2. Завантаж збірку для своєї платформи (Windows / macOS / Linux).
3. Встанови або запусти лаунчер.
4. Обери гру, локалізацію та натисни «Встановити».
5. Запускай гру — і насолоджуйся українською. 💛

---

🧑‍💻 Для розробників

# 1. Клонування репозиторію
git clone https://github.com/Vadko/lbk-launcher.git
cd lbk-launcher

# 2. Встановлення залежностей
pnpm install
pnpm approve-builds

# 3. Режим розробки
pnpm dev

---

⚖️ Ліцензія

Цей проєкт розповсюджується за ліцензією GNU GPL v3.

Це означає, що:

• ти можеш вільно використовувати програму;
• маєш право вивчати код і змінювати його;
• можеш поширювати копії та власні модифікації,

за умови, що похідні роботи також поширюються за ліцензією GPL-3.0 і містять текст ліцензії.