Difference between revisions of "Command-line arguments"

Latest revision as of 16:11, 21 February 2022

Mini Micro can be launched from the command line with certain command-line arguments to alter its default behavior.

Argument	Value	Effect	Example
`-screen-fullscreen`	0 or 1	start in full-screen mode	`-screen-fullscreen 1`
`-scale`	floating-point value	set screen scale to this factor	`-scale 2`
`-usr`	file path	mount given file or directory as /usr	`-usr /Users/alice/myFiles`
`-usr2`	file path	mount given file or directory as /usr2	`-usr2 /Users/bob/game.minidisk`

On Mac, to use these arguments you have two possibilities:

You cd inside the app bundle until you reach the executable, e.g. cd MiniMicro.app/Contents/MacOS.

Then you can launch the app like any Unix executable, e.g. ./Mini\ Micro -scale 3.

You cd into the folder where the MiniMicro bundle is installed, e.g. cd /Applications.

Then you can launch the app with the open command, passing arguments with `args`, e.g. open -a MiniMicro.app --args -scale 3.

@@ Line 14: / Line 14: @@
 |}
+== Usage Notes ==
+On Mac, to use these arguments you have two possibilities:
+# Running the bundle executable directly
+# Opening the app bundle with <c>open</c>
+==== 1. Running the bundle executable directly ====
+You <c>cd</c> inside the app bundle until you reach the executable, e.g. <c>cd MiniMicro.app/Contents/MacOS</c>.
+Then you can launch the app like any Unix executable, e.g. <c>./Mini\ Micro -scale 3</c>.
+==== 2. Opening the app bundle with <c>open</c> ====
+You <c>cd</c> into the folder where the MiniMicro bundle is installed, e.g. <c>cd /Applications</c>.
+Then you can launch the app with the <c>open</c> command, passing arguments with `args`, e.g. <c>open -a MiniMicro.app --args -scale 3</c>.
 [[Category:Mini Micro]]