LBK Launcher

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

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

---

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

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 оновлення каталогу — нові ігри та зміни з'являються миттєво
• 📡 Працює навіть офлайн (після першого запуску)
• 📢 Нотифікації про нові релізи самого лаунчера
• 🔧 Базові налаштування шляхів до ігор (де це потрібно)

---

🎮 Підтримувані ігрові платформи та лаунчери

Платформа / Лаунчер	Windows	macOS	Linux
Steam	+	+	+
GOG Galaxy	+	+	-
Epic Games Launcher	+	+	-
Rockstar Games Launcher	+	-	-
Heroic Games Launcher	-	-	+
Lutris	-	-	+

На Linux ігри GOG та Epic автоматично виявляються через Heroic Games Launcher та Lutris.

---

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

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 і містять текст ліцензії.