#Launchers

This is a collection of scritps and ICNS files intended for creating Mac OS application launchers. This was tested on Mac OS Monterey v 12.0.1

#Requirements

• Platypus https://sveinbjorn.org/platypus
• Uxn emulator https://git.sr.ht/~rabbits/uxn
• Uxn roms https://itch.io/c/248074/uxn-roms

#Modify the scripts for your computer

Edit the simple shell scripts included here for whichever app you want to launcherize.

The script first changes directory to the current user Desktop. With applications like Left, which can save files, it means that files will end up on the Desktop. You can change that to be your folder of preference.

cd [path where files will be saved]

The last line has a path to the uxn emulator, and then to the rom file of the application. Modify these to match where you've installed them. In my case, as you can see from these scripts, I have a folder I call "uxnery" in my user directory where I've cloned the uxn repo and various apps.

[path to uxnemu] [path to rom] -s 2

The -s 2 part will launch the app zoomed up, simply remove if you don't want that.

#Create a launcher with Platypus

Open Platypus, point to a shell script you've customized. Under the icon area, click the gear and choose "Select .icns File", pick the appropriate icon from this repo. Here are the other settings I used:

• Interface: None
• Uncheck "Remain running after execution"
• Uncheck "Strip nib file to reduce app size" in the save window

Save the app. Now you should be able to open it like other Mac apps. When you open an app, you'll see two icons one for the app, one for terminal, this is normal. The first time you launch the app, you'll get a notification with options about notifications from the app. You can ignore this as they aren't use and it won't show up again.

#Bonus tip

Add aliases for uxn apps in your .zshrc or .bashrc files or wherever you add aliases. This will greatly simplify accessing uxn apps no matter where you are in the terminal. For example to launch Left by simply typing: left or left [filename] the alias can be added with:

alias left="[path to uxnemu] [path to left.rom]"

#You read this far, extra bonus tip

If the apps feel a bit small in the context of Mac screen resolutions, you might enjoy the pixely goodness of a double sized window. Just press F1 to toggle into this view.