Rockbox General > Rockbox General Discussion

Rockbox simulator binaries for MacOS (ARM64)

(1/2) > >>

Simulators can be built and run on MacOS again. Apparently, this hasn't been possible for a while.

Puzzles and the SID codec aren't included for now, and there are issues with Lua even on arm64-based Linux, but the rest seems fine so far.
If you're interested in test-driving the latest changes, I put together a self-contained app bundle for arm64 that wraps simulator binaries for iPod4g, iPod video, Fiio M3k, and supporting files, giving you a way to test themes or plugins, and listen to music without having to compile or install any additional software. :) 

Shout, if you want to provide feedback of any sort, encounter something unexpected, or would like to see other targets included in the app bundle.

Download (v 1.2)

Corresponds to the latest dev build (03d326f) with the following patches applied, if you want to compile it yourself:

* 5278 Make simulator compile on MacOS
* 5279 Fix simulator crashing on MacOS
* 5282 iPod simulator: Adjust buttonmap
* 5285 Simulator: Migrate to SDL2 on MacOS
* 5286 Reopen audio device after adjusting sample rate
* 5287 SDL2: Fix deadlock when changing sample rate

Known issues

* After waking your Mac from sleep, playback in the Simulator may not resume.  Quit and relaunch the app as a workaround

* Lua and Lua-based plugins, such as boomshine or pixel-painter, will crash at launch.

* To get past Apple's warning message that appears when trying to launch unsigned apps, you can  right-click and select "Open" from the context menu. Subsequent launches do not require this.

* The simdisk (for an iPod video) is located at ~/Library/Application Support/Rockbox Simulator/ipodvideo

A default .rockbox folder containing system files will be automatically copied there when you select a target for the first time, during app launch, unless one already exists in the destination. Any themes that you may want to download and other changes to the installation go in that location as well.

Don't directly modify the contents of Rockbox instead!

* Command line output will not be visible if you're launching the app normally.
In case you do want to see it:

- Open the app bundle as a folder by right-clicking it and selecting Show Package Content.
- Drag the icon for the executable file rbsim in the subfolder Contents/MacOS to a new Terminal window
- Press Enter (with the Terminal window in the foreground) after, optionally, appending a target name to the command, separated from it with a space, such as ipodvideo, fiiom3k or ipod4g. Otherwise, the last-used will be picked or you'll be presented with a list of choices.

The main executable, rbsim, is a shell script that can be opened in a text editor to see what it's doing.

* To navigate the iPod simulator using a keyboard without a numpad, :

- MENU: Backspace or Escape
- PLAY: Spacebar
- SELECT: Enter
- UP/DOWN/LEFT/RIGHT: Cursor keys, as usual
- SELECT + PLAY: Space Bar + Enter, or F6 (used for WPS and File Browser Shortcut)

When holding down the function key, a Mac's media keys (F7,F8,F9) can alternatively be used for LEFT/PLAY/RIGHT while the app is in the foreground.

I would recommend Bilgus's keyremap plugin if you prefer an experience closer to the original iPod's firmware where MENU instead of LEFT can be used to go up a menu level, which I find a lot more intuitive.

In version 1.2, you can disable the background for all simulators by executing this command in Terminal (replace true with false to undo):

--- Code: ---defaults write org.rockbox.sim nobackground true
--- End code ---

When executing rbsim from the command line, parameters accepted by each one of the target binaries can now also be passed through to them:

--- Code: ---/path/to/rbsim ipodvideo --nobackground --debugwps --zoom 2
--- End code ---

Don't forget to include the name of a target as the parameter provided to rbsim in your command, such as ipodvideo before appending any other parameters.
To see a list of available parameters, execute
--- Code: ---/path/to/rbsim ipodvideo --help
--- End code ---

Since version 1.1, when launching the app, you're presented with a choice of simulators.  To prevent this list from showing and instead always open the last-used simulator, execute the following command in Terminal (replace true with false to undo):

--- Code: ---defaults write org.rockbox.sim skiplist true
--- End code ---


1.2 (230824)

Fixed: Playback sounded too slow when frequencies other than 44.1 kHz were selected

Fixed: App was unresponsive after adjusting sample rate when paused or playing

Changed: .debugwps and .nobackground files in simdisk folder are now ignored – see last note above

1.1 (230822)

SDL2 is now used instead of the SDL-1.2 compatibility layer

Enables hardware-accelerated rendering with vsync, which eliminates screen tearing that may have previously appeared within the app or in the rest of the system while the simulator window was visible.

SDL2 respects your Mac's key repeat rate, which can be adjusted in System Settings if necessary.

This should also fix the issue where the simulator window initially didn't gain focus when launched from the command line.

In addition to iPod video, binaries for iPod4g and Fiio M3K are included now

Additional fonts have been removed

Download the latest set from here (link near top of the page) instead, and manually add it to a simdisk, if required by a theme.

1.0  (230818)

Initial Release

Thank you very much for providing this.

I had previously tried to compile the simulator on my 13" M1 2020 and given up.

This should make any upcoming theming work much easier!

Good to hear there's other people interested in this. :)

A new, SDL2-based, version is now available for testing, by the way – the post above has been updated.

Uploaded version 1.2, see changelog above.

Anyone wondering whether there are Windows builds available, there are some outdated binaries available here:


[0] Message Index

[#] Next page

Go to full version