Skip to content

README.ru.md

Latest commit

 

History

History
101 lines (68 loc) · 12.8 KB

README.ru.md

File metadata and controls

101 lines (68 loc) · 12.8 KB
Raw

BoneCast 🦴📡

Новое в v0.5.4: уведомления об обновлении открываются из Steam. Удобное для геймпада окно показывает подробности, а при ошибке — ссылку на выпуск.

Twitch и YouTube в игровом режиме Steam — плагин Decky Loader для Steam Deck / Bazzite / SteamOS.

🌍 Языки: English · Français · Deutsch · Español · Italiano · Português · Nederlands · Polski · Русский

Часть набора плагинов Necrosiak, наряду со SkullKey, Steamcord и BC250-Toolkit. Интерфейс плагина переведён на 9 языков и автоматически следует языку SteamOS.

Что он делает

BoneCast помещает всё необходимое для стриминга на Twitch прямо в меню быстрого доступа Steam — без рабочего стола, без клавиатуры, полностью под геймпад от входа в аккаунт до выхода в эфир.

  • Один вход в Twitch (код устройства — удобно с геймпада): вы вводите короткий код на twitch.tv/activate, и BoneCast получает ваш ключ трансляции автоматически. Больше никакого копирования вручную.
  • ▶️ Вкладка YouTube (новое в 0.4.0) — выходите в эфир на YouTube по ключу трансляции, со своими настройками (разрешение, битрейт, кодировщик, микрофон, звук Discord, запись), экраном паузы и отключением микрофона в эфире, плюс оверлей чата YouTube поверх игры, без аккаунта. Одновременно только одна трансляция и один оверлей чата: Twitch и YouTube никогда не работают вместе. Новое в 0.5.0: войдите через аккаунт YouTube (код на google.com/device), и BoneCast сам создаст трансляцию, с названием, доступом и вашим чатом прямо из QAM, без ключа трансляции. Выберите задержку трансляции (обычная, низкая или сверхнизкая) (0.5.1).
  • Выход в эфир из QAM — одна кнопка запускает и останавливает RTMP-поток. Во время трансляции отображается значок ● В ЭФИРЕ.
  • Редактируемое название трансляции — задаётся из плагина, меняется даже во время эфира.
  • Автоматическая категория игры — считывается из запущенной игры Steam (работает и для ярлыков не из Steam) и обновляется на лету. Если у игры нет подходящей категории Twitch, используется Just Chatting.
  • Прозрачный оверлей чата — чат Twitch (только чтение), отрисованный поверх игры в игровом режиме (слой external-overlay gamescope), с нативными эмодзи + BTTV / 7TV / FFZ. Положение, размер и прозрачность настраиваются вживую из QAM, и оверлей остаётся видимым, даже когда Big Picture в фокусе. Сабы, рейды и биты (Twitch), Super Chat и новые спонсоры (YouTube) показываются выделенными карточками (0.5.0).
  • 📺 Смотрите Twitch поверх игры — до четырёх трансляций поверх игры в игровом режиме. Ваши отслеживаемые каналы в эфире показаны с превью и числом зрителей: нажмите — и трансляция запустится. Расположение, размер, прозрачность и частота кадров настраиваются в QAM; вы выбираете, чей звук слышать, с отдельной громкостью, всегда на аудиовыходе по умолчанию. (Для отслеживаемых каналов после обновления нужно один раз заново подключить Twitch, чтобы выдать новое разрешение.)
  • 🎬 Мгновенные клипы — в эфире одна кнопка вырезает последние ~30 секунд через API Twitch; клип появляется на вашей панели управления примерно через 15 секунд.
  • 💬 Пишите в свой собственный чат — отправляйте сообщения в свой чат Twitch прямо из QAM, без акробатики с клавиатурой поверх рабочего стола.
  • ⏸️ Режим BRB — одно нажатие заменяет изображение игры аккуратным экраном паузы и отключает микрофон; ещё одно возвращает вас обратно. Трансляция никогда не прерывается. Свой экран паузы (0.5.0): в режиме рабочего стола положите картинку brb.png в папку BoneCast-BRB в домашней папке. Можно и анимированный (0.5.1): brb.mp4, brb.webm или brb.gif, по кругу.
  • ⏺️ Локальная запись — сохраняйте сессию в MKV в ~/Видео/BoneCast/, параллельно с эфиром или вообще без стриминга (ключ трансляции не задействован). Сохраняйте во внутреннюю память, на SD-карту или внешний диск (0.5.1).
  • Отключение микрофона в эфире — отключите микрофон в трансляции одним нажатием, не останавливая эфир (и не заглушая свой звонок в Discord).
  • Настройки трансляции для каждого аккаунта — разрешение, fps, битрейт видео/аудио, интервал ключевых кадров и автоматически определяемый кодировщик (NVENC ▸ VAAPI ▸ программный x264). Предлагаются только кодировщики, которые действительно работают на вашем железе.
  • Аудиомост Discord (если установлен Steamcord): опциональный переключатель подмешивает ваш голосовой чат Discord в трансляцию, чтобы зрители слышали вашу группу — а вы продолжаете слышать её как обычно.

Как это работает

У Twitch нет API для отправки видео, поэтому выход в эфир всегда означает RTMP-push под капотом. BoneCast берёт это на себя:

  1. OAuth-поток с кодом устройства входит в ваш аккаунт Twitch и получает ключ трансляции, название и категорию через API Helix — вы никогда не касаетесь ключа.
  2. Изображение игры захватывается из gamescope и передаётся напрямую в ffmpeg через канал (без виртуальной камеры, ничего не нужно устанавливать), который кодирует его (аппаратно, если возможно, иначе программно через libx264) и отправляет на rtmp://…/<ваш-ключ>.
  3. Оверлей чата — это прозрачная поверхность WebKit на слое external-overlay gamescope, которая анонимно читает IRC Twitch и отображает эмодзи.

Всё управляется из QAM и переживает перезагрузки.

📸 Скриншоты

Панель выхода в эфир

Установка

  1. Установите Decky Loader.
  2. Включите режим разработчика в общих настройках Decky, затем настройки Decky → Разработчик → Установить плагин по URL: https://github.com/Necrosiak/BoneCast/releases/latest/download/BoneCast.zip (или возьмите BoneCast.zip со страницы Releases и установите из ZIP).
  3. Откройте меню быстрого доступа → BoneCast, войдите в Twitch и выходите в эфир.

BoneCast обновляется автоматически через GitHub Releases (отключается в разделе Обновления плагина).

🐧 Совместимость

BoneCast нацелен на все дистрибутивы Linux, способные запускать Steam в игровом режиме / Big Picture: одна сборка, определение всего внешнего во время работы (ffmpeg, libx264, GStreamer) и точная команда установки для вашего пакетного менеджера, показываемая в QAM, когда чего-то не хватает. Заметки о пакетах по дистрибутивам: OS-NOTES.md.

🐛 Баги и идеи — не стесняйтесь!

Нашли баг, что-то странно ведёт себя на вашем дистрибутиве или не хватает функции? Откройте issue — каждый отчёт напрямую определяет, что будет сделано дальше. По возможности укажите:

  • ваш дистрибутив и версию (Bazzite 42, CachyOS, Ubuntu 24.04…) и вашу видеокарту (для проверки кодировщиков)
  • версию плагина и что вы делали (выход в эфир, оверлей, OAuth…)
  • что вы ожидали и что произошло
  • логи: ~/homebrew/logs/BoneCast/

Запросы функций и отчёты «работает!» на необычных конфигурациях так же ценны.

Авторы

Создано и поддерживается Necrosiak. Часть набора плагинов Necrosiak для игрового режима Steam. Спасибо dreemur-e за тесты на Steam Deck OLED, идеи для YouTube и сторожа захвата, который победил зависшую картинку (#1).

Об использовании ИИ

При работе над проектом использовался ИИ (Claude от Anthropic и Codex от OpenAI) — для обратной разработки, программирования и документации. Не для графики и не для художественных текстов. Всё опубликованное просмотрено человеком, и за результат отвечаю я. Если вас это смущает — теперь вы знаете.

Поддержать разработку

Если этот проект вам полезен, вы можете поддержать его дальнейшую разработку на Ko-fi.

Поддержите меня на Ko-fi