Ebiten

A simple SNES-like 2D game library in Go

Stable version: v{{.StableVersion}} / Development version: v{{.DevVersion}}

• Web browsers (Chrome and Firefox on desktops) (powered by GopherJS)
• Windows
• Mac OS X
• Linux
• Android
• iOS

Features

• 2D Graphics
  • Geometry/Color matrix transformation
  • Various composition modes
  • Offscreen rendering
• Input
  • Mouse
  • Keyboard
  • Gamepads
  • Touches
• Audio
  • Ogg/Vorbis
  • WAV
  • PCM

Examples

The Gopher photographs by Chris Nokleberg are licensed under the Creative Commons 3.0 Attributions License.

Execute the examples

:; go get github.com/hajimehoshi/ebiten
:; cd $GOPATH/src/github.com/hajimehoshi/ebiten/examples
:; go run -tags example rotate/main.go

Note that you need to specify example tag.

Getting Started

Let's build a simple "Hello world!" game to get started with Ebiten. First create a new directory (mkdir hello_world), and change into it (cd hello_world). Type the following code into the main.go file:

package main

import (
        "github.com/hajimehoshi/ebiten"
        "github.com/hajimehoshi/ebiten/ebitenutil"
)

func update(screen *ebiten.Image) error {
        ebitenutil.DebugPrint(screen, "Hello world!")
        return nil
}

func main() {
        ebiten.Run(update, 320, 240, 2, "Hello world!")
}

Run the go run command to start the game. There you have it, your first Ebiten game!