JukaHub

The shell your handheld should have shipped with.

JukaHub turns a TrimUI handheld into a media and gaming console: YouTube on the couch, your ROM library with covers and save-resume, PlayStation, Xbox and PC streaming, Juka the voice assistant, and a few hundred things the stock menu never had. Run it as one folder on the SD card, or let the handheld power on straight into it. The stock system stays untouched underneath either way.

Free and open source, and it keeps itself up to date.

RecentWhat Continue resumes, the games you played last with their covers, then the apps you opened last. L1 and R1 change tabs.

Home layout

←→ Move Enter Open QE Tabs QE Sections Esc Back Move A Open L1R1 Tabs B Back Tap a tab or a tile to see what it does. Tap a tile to see what it does.

  • 1folder on the SD card, run as an app or as JukaHub OS
  • 4TrimUI handhelds: Smart Pro, Smart Pro S, Brick and Brick Pro, plus the Hammer
  • 50+themes, from Dark and Light to PS5, Switch 2 and Xbox styles
  • 391trophies of its own, beside RetroAchievements
  • 7interface languages

An app on the card, or the handheld's OS. Nothing underneath changes.

JukaHub runs on top of the firmware, not instead of it, on the stock OS, CrossMix and NextUI. Start it from the Apps menu like any app, or switch on JukaHub OS and the handheld powers on straight into it. There is no firmware to flash, so every step is reversible.

  • JukaHub OS when you want it.Settings → JukaHub OS → Boot into JukaHub OS makes it the first thing you see, or extract JukaHub-OS-Trimui.zip to the card's root. Hold Select while the logo shows to get the stock menu once; the stock system is never replaced. How it works
  • Leave from any screen.Hold Select + Start: JukaHub saves, stops what it started and hands the screen back to the stock launcher, even in the middle of a video.
  • Uninstall by deleting the folder.The app, its settings and its data live in Apps/JukaHub. The install guide says what to copy out first.
  • Your settings survive updates.They live in jukauser.json next to the app, and an update never touches them.
SDCARDThe whole installation
Apps/
└── JukaHub/
    ├── JukaHub            the application
    ├── launch.sh
    ├── config.json        its Apps-menu entry
    ├── jukaconfig.json    the interface
    ├── bin/               Remote Play helpers
    ├── androidrt/         the Android runtime
    ├── Inter-Regular.ttf
    └── background.jpg

The parts you would not expect from a media hub

Your PlayStation, your Xbox and your PC, on the couch

JukaHub has its own PS4 and PS5 Remote Play client: it finds the console, pairs once with the PIN from its Link Device screen and streams through a native helper, with no Python launcher. X1 streams your Xbox One or Series console through GreenOvercast.

PC streaming is JukaHub's own Moonlight client, made for Vibepollo, Apollo and Sunshine, and it shows your PC's library with its covers. With Vibepollo or Apollo it streams a screen made at exactly the handheld's size, so the Brick gets 4:3 with no black bars. (Preview)

Xbox Cloud Gaming and GeForce NOW sit under Start → Games as well. (Preview)

The PS4, PS5, X1 and PC pills in Home's header open each one in a press.

Juka, the assistant that knows your handheld

Press Menu anywhere and a glowing orb listens. Say "open YouTube", "volume 50" or "take a screenshot", name a game or a setting, or just ask a question. On the Smart Pro your speech is recognised on the device, with no account; a free Groq key makes Juka faster and lets it answer out loud.

In a game, hold Select + R2 and ask about the game you are playing. In Chat, Juka AI can look at the handheld before it answers "why won't my last game start?", and changes nothing until you say OK on screen. (Preview)

A game library that sorts itself out

Covers find themselves, and a homebrew or hack that has none gets one from two minutes of its own gameplay. When a console has several emulators, Which emulator? lists them with the one recommended for your handheld first, and Get more cores fetches the ones worth having in one press.

Hold Select + L2 in any game for the in-game menu: six save slots with pictures, Ask Juka and Quit to JukaHub. Start on a game renames it, chooses its cover or deletes it with everything named after it.

Link-cable games over Wi-Fi, and online

Press X on a game for Netplay. A JukaHub hosting on your Wi-Fi shows up live on every other one, and A joins it with your own copy of the ROM: no cable and no typed address, and link-cable games play together where the emulator core supports it.

Host online through one of libretro's public relays to play a friend on another network, with no port forwarding. No router at all? Tools → Hotspot makes the handheld a network of its own. (Preview)

Saves that never die

The Save Manager copies every emulator save folder it finds (RetroArch, PPSSPP, DraStic, Flycast) into a snapshot, and Save guard does it quietly at every start when something changed. Restoring takes a snapshot of your current saves first, so even a restore can be undone.

Snapshots are plain folders with a checksum for every file, so they work without JukaHub. Save sync carries a game's saves to Google Drive or a WebDAV cloud of your own around each session, and RomM and Syncthing are there too.

Your phone is the keyboard

Scan the QR on Home and your phone types into the focused field, works as a remote, and drops games, covers and music straight into the right folders.

Screen Share

The Smart Pro has no HDMI port, so JukaHub sends its screen, games too, to a browser on a TV or laptop. Off until you turn it on.

Dock and ambient

While it charges, the screen becomes a clock with the next alarm, the weather, what is playing and a slideshow of your photos.

Spatial audio

Virtual surround on headphones and wider stereo on the speakers, for videos, music and every game JukaHub starts.

Mail and calendar

Your inbox and your calendars on the handheld, with reminders, set up from your phone so nothing is typed with the D-pad. (Preview)

Chat and voice

The community Discord on the handheld, voice clips, voice channels with friends, and a Juka AI tab.

Synth

A pocket groovebox: seven lanes in a 16-step sequencer, pads in the song's key, and sounds you shape yourself.

Trophies

391 of JukaHub's own, for what you play, watch and make, next to RetroAchievements in the games that support it.

Stick lights

The rings round the Smart Pro's sticks take the colour and effect you pick, and glow with your voice while Juka listens.

Smart home

Drive Home Assistant entities, mirror toggles to MQTT, and check Pi-hole, your router and Tailscale from the couch.

Steam and Minecraft

Your Steam library with covers and play time, signed in with the Steam app, and every way to play Minecraft on the card in one place. (Preview)

A terminal you can drive

The Command Deck fills in common commands with pickers instead of typing, and apt installs Ubuntu programs onto the card. (Preview)

Safe to try, easy to undo

Updates arrive as an icon in the header and install with one press. Before anything is unpacked, JukaHub checks the archive against the digest GitHub publishes and, when the release is signed, its Ed25519 signature. If a new build misbehaves at startup, the previous one comes back by itself.

  • Safe mode is one chord away.Hold L + R + Start while JukaHub starts for a recovery card: the previous version, your last good settings, or a reset. Three failed starts in a row open it by themselves.
  • A lock of your own.A startup lock asks for a button code, a password or your voice at power-on, and stores only a salted hash of it.
  • Nothing about you is uploaded unless you ask.Anonymous diagnostics are off by default. Turned on, they carry the build, device model and platform, with no install ID, account, file name, setting or usage history.
  • File servers start when you start them.FTP and SFTP run only after you press their row, use a password made up for that start, and switch themselves off after 15 idle minutes.

Install in five steps

No firmware swap, nothing to compile. You need the handheld, its SD card and Wi-Fi.

  1. Download JukaHub-Trimui.zip from the latest release.
  2. Turn the handheld off and put its SD card in your computer.
  3. Extract the zip. Inside is one folder, JukaHub-Trimui.
  4. Rename it to JukaHub and copy it into the card's Apps folder, so the app ends up in Apps/JukaHub.
  5. Put the card back, power on, and open Apps, then JukaHub.

The first start asks for your language, then downloads yt-dlp and ffmpeg by itself, which takes a minute or two once. If JukaHub is not in the Apps menu, reboot: the stock launcher only looks in Apps when it starts.

Download JukaHub

Every button fetches the newest published build. Updates are checked against GitHub's digest before they install.

JukaHub-Trimui.zipThe app: Smart Pro, Smart Pro S, Brick, Brick Pro and Hammer Download
JukaHub-OS-Trimui.zipJukaHub OS: extract to the card's root, power on into JukaHub Download
JukaHub-Windows.zipTry it on a PC first Download

Tabs the default HomeSix tabs in the top bar; L1 and R1 change the page, and each page can be a grid, rows, a list, a carousel or compact icons.
Standard and four more layoutsThe dashboard, a hero grid, a carousel, widgets you arrange, or a console-style home. L2 edits whichever one you pick.

Every screen is a file you can change

Each screen is jukaconfig.json: its elements, where they sit, what they do and the theme they wear. The web builder edits the same file the device reads, so a layout moves between your browser and the card without a rebuild.

Live Builder, from a copy of the builder you run on your own computer, pushes a design to a running handheld over Wi-Fi and reloads it in place. Share turns a design into a single link: nothing is uploaded, because the design is compressed into the link itself with keys and tokens stripped first, and whoever opens it can remix a copy.

jukaconfig.json, scene Main{
  "type": "button",
  "style": "tile",
  "text": "Media",
  "placeholder": "Watch and listen",
  "icon": "media",
  "x": "528", "y": "160",
  "width": "720", "height": "152",
  "trigger": "change_scene:Tube"
}
On the device

Made in the open

JukaHub is free software under the GNU AGPL v3, built with the people who use it. Most of what is on this page started as a request in Discord. Ask there, report what breaks, or pick up an issue labelled good first issue.

Thanks to NiNjaMAN1210 for his extensive testing and help developing new features, Nevrdid for finding and documenting bugs, Arthur Gregorio for Go guidance, StarDrive and DigestPrism for supporting the app, @Dio for key-security contributions, and everyone in the Juka Discord.

Questions

Does JukaHub replace my firmware?

No. It is an app in Apps/JukaHub that runs on top of the stock OS, CrossMix or NextUI. Even JukaHub OS is a way of starting that app at power-on, not a new firmware: nothing on the firmware's partitions is written, and the stock launcher is one Select + Start hold away whenever you want it.

Which handhelds does it run on?

The TrimUI Smart Pro and Smart Pro S at 1280 × 720, and the Brick, Brick Pro and Hammer at 1024 × 768. JukaHub detects the model and picks its layout and drivers by itself. A Windows build is there for trying it on a PC.

Does it need the internet?

Only for what lives online: videos and streams, the weather, updates, cloud saves and the like. Your games, saved music and videos, books and photos all work with Wi-Fi off, and on the Smart Pro so do voice commands, once the offline speech package has downloaded by itself.

Can it play Android, Windows or Steam games?

Some, and JukaHub is honest about which. The APK Store checks each APK and adds the native ones worth trying to Games through AndroidRT; most Android apps are Java and cannot run. Windows Apps runs small, older programs through Box64 and Wine. Steam games play on the handheld when PortMaster has a port of them, and the rest stream from your PC through Moonlight. These are the newest parts of JukaHub and are still being proven on hardware.

How do I uninstall it?

Turn off Boot into JukaHub OS and Start at login if you turned them on, then delete the Apps/JukaHub folder. Copy your save snapshots and downloads out of it first if you want to keep them. The install guide has the details.

Does it cost anything or need an account?

No. JukaHub is free and open source under the GNU AGPL v3, and it needs no account of its own. Features that use another service use your account there: a PS5 needs your PSN account ID, achievements need RetroAchievements, Chat needs Discord, and a Groq key makes Juka faster.

What does it send about me?

Nothing, unless you turn on anonymous diagnostics under Tools → Community & support. Then, about every ten launches, it files a public issue with the build and version, the device model, platform, OS and architecture, the CPU core count, the size of its configuration and whether safe mode is on. There is no install ID, account, file name, setting or usage history in it. See the privacy page.

What if an update breaks something?

An interrupted update is rolled back at the next launch, and three failed starts in a row open safe mode by themselves. You can also hold L + R + Start while it starts for safe mode and a recovery card, or stay on the Stable update channel, which only offers tested releases.

Where do I get help?

Ask on Discord, or open Tools → Community & support → Report a bug on the device: you read the report, with its redacted diagnostics, before it is sent, and the handheld shows the issue number it became.