Creates MacOS app bundles to launch roms directly through the Finder.
Requires: fzf, jq and fileicon if you are running MacOS 26 (Tahoe or later).
With homebrew installed, get the required dependencies.
brew install fzf jq fileiconusage: rashortcuts [OPTION]... [OUTPUT]
Playlists:
--favorites favorites playlist
--history history playlist
-p, --playlist path/to/playlist.lpl
If a playlist is not provided, fzf will list them automatically.
Process without fzf game selection.
--process-all process all entries for a given playlist
--process-existing process entries for a given playlist that already exists in
the output directory.
Last argument should point to the directory where the shortcut.app will be created.
Defaults to the current working directory.
Custom templates:
-t, --template path/to/template-folder
An optional template for building shortcuts. It defaults to the folder named
"template" located in the same directory as this script. If a hidden .template
folder exists in the output directory, it will be used instead but --template
will always take presidence.
-h, --help view help.
Process all favorites. Last argument (optional) is the output path.
rashortcuts --favorites --process-all ~/Applications/RetroArch/FavoritesOr just cd to the directory where you want to create shortcuts and pick a playlist and games when prompted. Type to search and use tab or ctrl+i to select multiple items and press return. Use ctrl+j/k or the arrow keys to navigate. esc to cancel.
cd ~/Applications/RetroArch
rashortcuts- The script depends on existing playlists with valid entries and boxart for the app icon. The app icon will fall back to the assets within
xmb/retrosystem. - Using
--process-existingis primarily meant to update existing shortcuts but it depends on the name not being changed. This can happen when renaming a game in the playlist or a rescan with updated databases.