The Corona Simulator

The Corona Simulator

In this guide we’ll walk through the basic functionality of the Corona Simulator.

There are three files that will launch the simulator. Two are meant to be run from the terminal, and the other by itself. The terminal-launched versions will give you access to the debugger as well as display any errors that may occur. These three files are named ‘Corona Simulator’, ‘simulator’ and ‘debugger’.


To launch the Corona Simulator, simply double click its icon. In the dialog that appears, navigate to your project directory and click "Open".



The project simulator itself has all the similar features across the three versions mentioned earlier:

  • Re-launching: If you modify your code, rather than restarting the simulator, you can relaunch from within the simulator by either going to ‘File’ and choosing ‘Relaunch’ or typing ‘command-R’. If you’ve saved the changes to your main.lua file, you will now see the latest version in the simulator.

  • Video Recording: if you want to show off your app or need to demonstrate a functionality or a bug, you can record a video of it at 15fps. To access this, go to the ‘File’ menu and select ‘Record Video’ or hit ‘control-R’. You will then be prompted for a file name and location to save your video. Once you have done this, your video will start recording. To stop, simply go back to the ‘File’ menu and select ‘Stop Recording’ or ‘control-S’. The file is saved in quicktime format.

  • Accelerometer Control: You can change the simulated orientation of the device or send a ‘shake’ command by accessing the ‘Hardware’ menu, or by pressing ‘Command’ along with the left, right, or up arrows.

  • Suspend: You can suspend your simulation at any time by accessing the ‘Hardware’ menu and selecting ‘Suspend’ or ‘Command’ and the down arrow. This will pause your project’s simulation. To resume, access the ‘Hardware’ menu again and select ‘Resume’ or press ‘Command’ and the down arrow again.

To access the terminal launch versions, simply drag either the ‘simulator’ or ‘debugger’ to the terminal and hit ‘Return’, or double-click them to launch a terminal window automatically. Both will ask you to navigate to your project directory and click "Open". The debugger requires a command in order to begin. Type ‘help’ at the prompt for a list of those commands.