YouTube Music for Hackhub

Неофициальное приложение YouTube Music внутри Hackhub: поиск настоящих треков, популярная музыка, новинки, понравившиеся композиции, воспроизведение, пауза, перемотка и громкость.

Версия: 0.6.1. Поддерживаются macOS и Windows.

Автор: Stanislav Sorochenko — Staks-sor.

Репозиторий: github.com/Staks-sor/staks-youtube-music.

• лицензионная Steam-версия Hackhub;
• Node.js 18 или новее;
• Python 3.10 или новее;
• Chrome, Firefox, Safari, Brave, Edge, Chromium или Vivaldi для входа в аккаунт;
• интернет при первой установке и первом запуске.

Закройте Hackhub перед установкой. Установщик меняет app.asar, потому что стандартная политика безопасности Hackhub блокирует локальный музыкальный Bridge. Перед изменением всегда создаётся резервная копия; при ошибке исходный файл восстанавливается автоматически.

1. Распакуйте ZIP полностью.
2. Запустите install-macos.command двойным щелчком.
3. Если macOS блокирует файл: нажмите по нему правой кнопкой → Открыть.
4. После сообщения Installation complete запустите Hackhub из Steam.

Установщик читает список библиотек Steam и обычно сам находит игру. Если не нашёл:

./install-macos.command --game-dir "/Volumes/GAMEFARM/SteamLibrary/steamapps/common/Hackhub"

1. При установке Python включите пункт Add Python to PATH.
2. Распакуйте ZIP полностью.
3. Запустите install-windows.bat.
4. После успешного сообщения запустите Hackhub из Steam.

Для нестандартной библиотеки Steam откройте Command Prompt в папке мода:

install-windows.bat --game-dir "D:\SteamLibrary\steamapps\common\Hackhub"

Bridge запускается вместе с Hackhub. При первом запуске он создаёт локальное Python-окружение и загружает зависимости, поэтому статус может оставаться Bridge offline несколько минут. Откройте YouTube Music → Настройка → Проверить Bridge.

Для обычного поиска авторизация не нужна. Нажмите найденный трек — он загрузится в локальный кэш и начнёт играть внутри Hackhub.

1. В приложении откройте Аккаунт.
2. Выберите браузер и нажмите Открыть YouTube Music.
3. Войдите в Google самостоятельно.
4. Вернитесь в игру и нажмите Я вошёл — проверить.
5. На macOS подтвердите системный запрос Chrome Safe Storage кнопкой Разрешить и, если потребуется, паролем Mac.

Мод не просит пароль Google и не копирует cookies в свою папку. yt-dlp читает активную браузерную сессию напрямую. Закрытие браузера иногда требуется, если его база cookies заблокирована.

Steam может заменить app.asar при обновлении или проверке файлов. Если приложение снова показывает Bridge offline, закройте игру и повторно запустите установщик свежей версии мода.

Закройте Hackhub. В установленной папке мода запустите:

• macOS: uninstall-macos.command;
• Windows: uninstall-windows.bat.

Удаление восстанавливает сохранённый app.asar только если файл не менялся после установки. Если Hackhub уже обновился, установщик не откатывает игру на старую версию и просто сообщает об этом.

• Bridge offline: подождите завершения первой установки зависимостей; проверьте наличие Python; запустите start-bridge.command или start-bridge.bat вручную и прочитайте ошибку.
• Failed to fetch: повторно запустите установщик — CSP-патч отсутствует или был удалён обновлением игры.
• Не читается аккаунт: войдите на music.youtube.com именно в выбранном браузере, закройте браузер и повторите проверку.
• Трек не запускается: очистите кэш в настройках и повторите поиск; YouTube иногда меняет доступные аудиоформаты.
• Порт 18741 занят: закройте лишние процессы Bridge и перезапустите Hackhub.

Bridge слушает только 127.0.0.1:18741. Команды принимаются только от локального документа в Electron/Hackhub и отклоняются от обычных сайтов и обычного браузера. В bridge-data сохраняются только обложки, аудиокэш, настройки выбранного браузера и текущее состояние плеера.

Проект не связан с Google, YouTube, YouTube Music, Hackhub или HotBunny. Пользователь самостоятельно отвечает за соблюдение правил YouTube и законодательства своей страны. Не распространяйте загруженный кэш и не используйте мод для обхода ограничений доступа.

Исходный код мода распространяется по лицензии MIT. Файлы Hackhub в релиз не входят.