HBLauncher README

README проекта с github.com/ravensclawx/HBLauncher. Одним файлом markdown: README.md.

HBLauncher

HBLauncher interface

A native AArch64 homebrew launcher and app SDK for Nintendo Switch 2, by RavensClawX. The launcher runs inside a SmileBASIC application process with an externally established, verified 4/4 session. CPU code handles the UI layout, animation, and input; Vulkan draws the interface.

Features

Game ports, emulators, commercial assets, media, console keys, and compiled app payloads are excluded. Build the included demos from source.

Game ports

These ports are maintained by @ravensclawx in separate repositories:

Set up HBLauncher using Getting started, then follow each port's README for build, installation, and file-server instructions. Both require your own supported game disc image.

Build

Use Linux with Node.js 18+, Python 3 with Pillow, GCC, the AArch64 GNU compiler/binutils, glslang, SPIR-V Tools, and DejaVu fonts. The offline tests also need QEMU user emulation and a Vulkan implementation such as Mesa lavapipe. On Debian/Ubuntu, the dependency packages are:

sudo apt install nodejs python3 python3-pil gcc gcc-aarch64-linux-gnu \
  binutils-aarch64-linux-gnu glslang-tools spirv-tools fonts-dejavu-core \
  qemu-user libvulkan1 mesa-vulkan-drivers

From the repository root:

sh tools/build-all.sh
sh tests/run.sh
./hbl-start --mock

If Node is installed outside PATH, set HBL_NODE to its executable path. The build regenerates the font atlas, shader blobs, and ABI metadata, then builds the launcher, apps, hardware probe, SDK example, and offline preview. Generated binaries and local state are ignored by Git.

To render preview frames after building:

./build/preview/hbl-preview tests/preview/out 6

The preview uses a synthetic catalog. Tests default to the lavapipe ICD at /usr/share/vulkan/icd.d/lvp_icd.json; set VK_ICD_FILENAMES if your system uses a different path.

Console setup

Provide a separate ns2jb-kurumuz checkout and establish the required session. The launcher requires verified 4/4 before mapping native code.

export HBL_NS2JB=/path/to/ns2jb-kurumuz
./hbl-start --preflight
./hbl-start

See Getting started and Recovery for session setup and diagnostics. --spawn --guide additionally requires the external controller tooling described there.

Variable Purpose
HBL_NODE Node executable
HBL_NS2JB External session runner checkout
HBL_APPS Alternate app package directory
HBL_RPC_TARGET Console RPC address
HBL_PICO_TOOL External controller tool for guided setup
HBL_COMPAT_ROOT Optional external legacy compatibility projects

Develop an app

python3 sdk/tools/hbx-new.py apps/my-app "My App"
python3 sdk/tools/hbx-build.py apps/my-app

Read the SDK guide, SDK reference, and raw Vulkan example. The optional Linux personality runtime requires a separately configured musl toolchain and is not built by the default build.

Source layout

Directory Contents
launcher/ Native launcher, navigation, and Vulkan UI
host/ Session management, package loading, and app lifecycle
sdk/ ABI headers, runtime, templates, examples, and build tools
apps/ Original demo source packages
assets/ Font atlas and font license notice
docs/ Architecture, SDK, setup, and recovery guides
tests/ ABI, mock lifecycle, navigation, and rendering checks
tools/ Asset generators and development utilities

Source release

Run python3 tools/package-release.py to create release/hblauncher-native-source.tar.gz from the current source tree. It excludes Git history, build products, local settings, and user app assets, and checks the included files for private workstation identifiers. Use this archive for a fresh public repository; the existing local Git history still contains earlier versions and is not sanitized by deleting working files.

License

MIT, copyright RavensClawX and contributors. The font atlas retains its separate third-party notice. This independent project is not affiliated with or endorsed by Nintendo.

HBLauncher (ravensclawx/HBLauncher)

Ищем в базе…

Что это такое?HBLauncher — нативный лаунчер хомбрю и SDK для приложений под AArch64 на Nintendo Switch 2. Он работает внутри процесса приложения SmileBASIC с проверенной сессией: код на CPU управляет интерфейсом, а Vulkan выводит его на экран.
Это готовое приложение-лаунчер или набор инструментов, чтобы создавать собственные хомбрю?Это и то, и другое: нативный лаунчер с каталогом приложений и навигацией с геймпада на консоли, а также ABI SDK с версионированием, рантайм и библиотека интерфейса для написания собственных хомбрю-приложений, которые лаунчер может запустить.
Как запустить HBLauncher на моей Switch 2?Сначала соберите лаунчер и демо из исходников в Linux (готовых бинарников не поставляется), затем настройте отдельную копию репозитория ns2jb-kurumuz на консоли и установите нужную проверенную сессию, прежде чем лаунчер сможет разместить нативный код в памяти.
Что нужно установить для сборки?Нужны: Linux, Node.js 18+, Python 3 с Pillow, GCC, компилятор и binutils GNU для AArch64, glslang, SPIR-V Tools и шрифты DejaVu. Для офлайн-тестов дополнительно нужны эмуляция QEMU user и реализация Vulkan, например Mesa lavapipe.
Есть ли в репозитории порты игр, эмуляторы или готовые файлы игр?Нет. Порты игр, эмуляторы, коммерческие игровые ресурсы, медиафайлы, ключи консоли и скомпилированные пакеты приложений намеренно исключены; из исходников собираются только входящие в репозиторий демо-приложения.
Могу ли я попробовать без настоящей модифицированной Switch 2?Да: есть имитационный бэкенд консоли и офлайн-режим предпросмотра Vulkan (проверен на Mesa lavapipe), так что можно разрабатывать и отрисовывать кадры предпросмотра без реального железа.
Что за порты Animal Crossing и Twilight Princess, о которых говорится в README?Это отдельные игровые порты, которые поддерживает сообщество (основаны на ACGC-PC-Port и Dusklight) и которые работают поверх HBLauncher. Для каждого нужен собственный образ диска с игрой, законно вам принадлежащий.
Что SDK даёт разработчикам приложений из коробки?Заголовки ABI, автономный рантайм с поддержкой ввода, сенсорного экрана, таймингов, кучи и ведения журнала, небольшую библиотеку 2D-интерфейса, шаблоны сборки и низкоуровневый пример Vulkan Hello World/Triangle, с которого можно начать.
Можно ли создать очищенный релиз исходников моего форка?Да: команда python3 tools/package-release.py собирает архив релиза, из которого удаляются история Git, результаты сборки и локальные настройки, а оставшиеся файлы проверяются на наличие личных идентификаторов рабочей станции.
Какие есть похожие проекты?ios-sweet, LiberNT, ios-topaz, linux, d2r-mobile, hackios-xnu-userland, frank-386, re4
Автор
ravensclawx
Размер
25.8 MB
Звёзды
161
Возраст
26 д
Коммиты · 90 дней