Your handheld. On your Mac.

Connect a data cable and approve Android debugging. Start with USB; the handheld stays connected while you play.

Wireless Debugging pairing and recovery have been tested on the RG405V with GammaOS and Android 12, including Wi-Fi loss and reconnection without root. Broader firmware, network and long session testing remain open.

The companion can be installed through Puck over authorized USB. Installation and updates have been tested on the RG405V with GammaOS and Android 12.

Recovery after Wi-Fi toggles was tested without root, and a user reported recovery after walking away in about 10 to 20 seconds. Two physical Macs, different access points, reboot and stock firmware still need tests. Recovery does not guarantee an uninterrupted game session.

Development is centered on the Anbernic RG405V. Other Android models and firmware need complete connection, playback, control and exit tests.

Puck remembers separate Mac destinations. Selecting and using two physical Macs with the same handheld has not yet been tested end to end.

Puck provides search, system browsing, recent games and cover artwork. Your game files stay on the handheld; library information and artwork are stored on the Mac.

Choose a game from your Mac library. Puck uses the handheld’s Daijisho selections or an explicit RetroArch playlist mapping. ES-DE settings for starting a new game are still being integrated.

Bring a supported RetroArch game already running on your handheld to the Mac. Pickup has been tested through ES-DE and Daijisho on the RG405V.

Live game video has been observed in the native Mac player on the RG405V with RetroArch. Performance and display behavior on other combinations remain to be tested.

Sound streaming, volume and mute are implemented. A complete sound test across the intended devices and connection methods is still needed.

The Mac player supports fullscreen and integer scaling. Aspect fitting and refusing cropped integer frames have regression checks. Resolution and display behavior on additional handhelds still need coverage.

Import RetroArch playlists or scan ROM folders on your handheld. Finding your games does not require Daijisho.

A screenshot action is implemented in the player. Saving the correct game image and finding it afterward still need hardware verification.

Physical controls have been observed working on the RG405V after a RetroArch return, with Zelda responding and the user confirming movement. Other devices, cores and control assignments need testing.

Tested setupRetroArch · RG405V

Keyboard gameplay input is implemented and has reached RetroArch on the RG405V. The September 20 UHID fix corrected Android key delivery; a later live Zelda test confirmed Mac Return advanced the game. More device and emulator combinations still need coverage.

Mac controller input paths are implemented. Controller models, player assignment, emulator mappings and live handoff behavior still need hardware testing.

Mac Escape pause and resume were exercised on the RG405V without restarting RetroArch. The observed game process remained alive.

Rebind game actions in Controls settings and reset them to defaults. Mapping persistence, reassignment and reset behavior have automated checks. Emulator bindings and controller ownership still vary by setup.

An optional companion service routes supported Home, Guide or Menu inputs during an active stream. Android permissions, reserved system buttons and physical input behavior vary by handheld.

The player has a fast forward control linked to the emulator command path. Actual behavior and compatibility still need hardware verification.

Tested setupRetroArch · RG405V

Save and quit is verified with Genesis Plus GX on the RG405V. Puck closes RetroArch normally and collects an accessible save backup. Other emulator and device combinations need testing.

Tested setupRetroArch · RG405V

Available save backups stay on your Mac. Coverage depends on the emulator’s configuration and Android access permissions.

Live return is available, but can leave the picture frozen or cropped, or the game unresponsive. Save in the game before ending a Mac session. A surviving process does not prove playable progress.

Save and load slot controls are implemented. Successful creation and restoration need to be tested for each relevant RetroArch core and configuration.

Puck can inspect and adjust supported RetroArch saving settings. A configured setting does not prove a saved state will restore; game overrides, core behavior and complete restore tests still matter.

The current interface can report save backups, but the backup restore interface is still incomplete. A collected backup is not proof of a tested restoration.

Puck does not currently provide cloud save synchronization. Games and emulator saves live on the handheld; available backups are collected locally on the Mac.