All guides

Astris on Mac: setup, controllers and remote play

Find Astris’s Mac release, check Apple silicon requirements, select an existing game library and test controllers before remote play. Once your game is running on your Mac, pair a compatible gamepad with your iPhone and use Remoted to try playing from your phone.

Check your Mac and game

The inspected Astris 1.0.32 release lists Apple silicon and macOS 15 or later. Its release tag is astris-1.0.32; the Mac image is Astris-1.0.32+2398e7c80.dmg. Use the project’s GitHub releases or its Codeberg mirror and check for newer requirements.

Install Astris and select your library

  1. Download the Mac DMG from the project release, open it and copy Astris to Applications. If macOS asks for approval, follow Apple’s app-specific opening instructions.
  2. Open Astris and use its library settings to select the folder containing your existing games. Keep external drives mounted. Public Mac UI documentation is limited, so exact labels can vary by build.
  3. Open a game with the default settings. Confirm actual movement, sound and a save that reopens before adjusting graphics or adding remote input.

Controller recognition is only the first check

In input settings, choose the player, input device and emulated controller type, then apply the bindings. A reported SN30 Pro problem does not establish that all 8BitDo controllers fail; record the exact device, connection mode and build.

Motion support has separate issue reports. Astris’s changelog also records fixes involving audio output changes, Finder launches and background keyboard input. An older workaround may not apply to the current release.

Preserve a working baseline

Use the application’s save-location controls when available and back up saves with the game closed. Compare the same game update before and after an application update. If the controller is missing, connect it first and reopen Astris before remapping.

Start with a working local game

  1. Start the game on the Mac with the project’s default settings. Reach actual gameplay; a title screen alone does not establish compatibility.
  2. Check movement, sound and a normal in-game save. Close and reopen the game to confirm the save loads. Record the Mac model, macOS, application build and game update before changing settings.

Test the controller in gameplay

  1. First connect a controller directly to the Mac and select it in the application’s input settings. Choose the active player and controller type, map the inputs, then apply or save.
  2. Test both sticks, the directional pad, face buttons, shoulders, triggers and stick clicks during gameplay. Button letters may differ between controller layouts; map actions and positions.
  3. Device recognition, working buttons, motion controls and rumble are separate checks. A controller in the device list does not prove all of them work.

Remote play from iPhone or iPad

Available on the App Store · iOS 26.5 or later

macOS 26 or later · Apple silicon and Intel · Signed and notarized

  1. Turn on game controllers in Remoted Link on the Mac. Use the gamepad setup guide for the steps that match your Link version.
  2. Pair the physical controller to your iPhone or iPad, then connect through Link to the existing Mac desktop. On-screen controls use the same host setup. Keep the Mac awake and Remoted active.
  3. Open the game’s input settings again, choose the forwarded controller for the active player and save the mapping. Test gameplay, audio and saving again through the remote session.
  4. Use the controller guide for the current steps. Mac audio needs a supported High Performance connection; a private virtual-display session does not provide this controller path.

Find the cause of a problem

  • If the game crashes, glitches or runs slowly on the Mac itself, start with that project’s compatibility notes. Remote play does not fix local emulation or graphics problems.
  • If the picture works but buttons do not, check the forwarded controller, player slot and bindings. Reopen the game if it shows an old device list.
  • If local sound works but remote sound or video fails, compare the same scene locally and remotely, then use the audio or performance guide. Change one setting at a time.

Sources and further setup

Remoted is an independent remote desktop app and is not affiliated with, endorsed by or sponsored by Nintendo. Nintendo Switch is a trademark of Nintendo.