Getting Started

Video Tutorial

Creating a New Project

First open Gideros Studio. Then create a new project from “File→New Project” menu. Name your project “HelloBall”:

New Project

Here is our development environment where you create/manage assets and run your code:

Gideros Studio fig1

Your First Code

Right click the project name at Library and select “Add New File…” to add your first Lua code:

Add New File

Name your file “main.lua” and click OK.

Add New File 2

Now double-click main.lua and write

print("Hello Ball")

Gideros Studio fig2

Running in Gideros Player

At the first part of this tutorial, we just want to run our code in “Gideos Player” and print “Hello Ball” to the console.

Now select “Player→Start Local Player” to start Gideros Player.

Gideros Player fig1

After “Gideros Player” opens, the start and stop icons become enabled.

Start Stop

This means “Gideros Studio” connects to “Gideros Player” and ready to upload your code and assets and then run the project. Press start button (or select “Player→Start” from main menu) to run the project:

Gideros Studio fig3

Now you see the output of your project at the “Output” panel.

Adding Assets

Now let’s add some images to our asset library. Download field.png and ball.png and copy these images to your project directory. Then, right click the project name at Library and select “Add Existing Files…” to add your image files to the project.

Add Existing Files

More Code

And then write the code below:

local background ="field.png"))

local ball ="ball.png"))

ball.xdirection = 1
ball.ydirection = 1
ball.xspeed = 2.5
ball.yspeed = 4.3


function onEnterFrame(event)
    local x = ball:getX()
    local y = ball:getY()

    x = x + (ball.xspeed * ball.xdirection)
    y = y + (ball.yspeed * ball.ydirection)

    if x < 0 then
        ball.xdirection = 1

    if x > 320 - ball:getWidth() then
        ball.xdirection = -1

    if y < 0 then
        ball.ydirection = 1

    if y > 480 - ball:getHeight() then
        ball.ydirection = -1


stage:addEventListener(Event.ENTER_FRAME, onEnterFrame)

Gideros Studio fig4

After pressing start, you’ll have a nice ball moving around and bouncing from the edges:

Gideros Player fig2

Running on Device Player

IOS device

To run project on IOS device you need to build and install the GiderosiOSPlayer XCode project ( comes with the installation. You need to be an approved Apple Developer for iOS and need to install the XCode with iOS SDK.

Android device

To run project on Android device you need to install the GiderosAndroidPlayer.apk (comes with the installation) on your device.

Windows Phone device

To install the Windows Phone player on a Windows Phone you must first unlock you Windows Phone. Run the program "Windows Phone Developer Registration (8.1)". It comes with Visual Studio (Windows Phone SDK 8.1 folder), connect your Windows Phone using a USB cable and click Register. After that you can unzip WindowsPhone player and deploy it using Windows Phone Application Deployment and selecting

Windows RT (Metro style) device

Due to Microsoft limitations, you can't run Windows Store app player on the same device as your Gideros Studio are. Gideros Studio just won't connect, due to sandboxing nature of Windows Store apps. You need to run Windows app player on another device (like another tablet or computer)

Run project

After installing GiderosPlayer to your device, open the player and enter the IP of your device (which will be shown in Gideros Player) from the menu “Player→Player Settings”.

Player Settings

When the Start and Stop buttons appear enabled, press Start to run your code on device.