## File: README.md # Ebitengine (v2) [](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2) [](https://github.com/hajimehoshi/ebiten/actions?query=workflow%3Atest) **A dead simple 2D game engine for Go** Ebitengine (formerly known as Ebiten) is an open source game engine for the Go programming language. Ebitengine's simple API allows you to quickly and easily develop 2D games that can be deployed across multiple platforms. * [Website (ebitengine.org)](https://ebitengine.org) * [API Reference](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2) * [Cheat Sheet](https://ebitengine.org/en/documents/cheatsheet.html) * [Awesome Ebitengine](https://github.com/sedyh/awesome-ebitengine) ## Platforms * [Windows](https://ebitengine.org/en/documents/install.html?os=windows) * [macOS](https://ebitengine.org/en/documents/install.html?os=darwin) * [Linux](https://ebitengine.org/en/documents/install.html?os=linux) * [FreeBSD](https://ebitengine.org/en/documents/install.html?os=freebsd) * [Android](https://ebitengine.org/en/documents/mobile.html) (Cgo required) * [iOS](https://ebitengine.org/en/documents/mobile.html) (Cgo required) * [WebAssembly](https://ebitengine.org/en/documents/webassembly.html) * Nintendo Switch (Cgo required) * Xbox (Cgo required) (Xbox support is limited and not available to everyone. Negotiations are currently underway to make it accessible to all.) For installation on desktops, see [the installation instruction](https://ebitengine.org/en/documents/install.html). ## Features * 2D Graphics (Geometry and color transformation by matrices, Various composition modes, Offscreen rendering, Text rendering, Automatic batches, Automatic texture atlas, Custom shaders) * Input (Mouse, Keyboard, Gamepads, Touches) * Audio (Ogg/Vorbis, MP3, WAV, PCM) ## Packages * [ebiten](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2) * [audio](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/audio) * [mp3](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/audio/mp3) * [vorbis](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/audio/vorbis) * [wav](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/audio/wav) * [colorm](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/colorm) * [ebitenutil](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/ebitenutil) * [inpututil](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/inpututil) * [mobile](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/mobile) * [text/v2](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/text/v2) * [vector](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/vector) * [exp/shaderprecomp](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/exp/shaderprecomp) * [exp/textinput](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/exp/textinput) * [exp/vmhost](https://pkg.go.dev/github.com/hajimehoshi/ebiten/v2/exp/vmhost) ## AI coding agents If you use an AI coding agent to write or modify Ebitengine code or applications, point it at the [`skills`](skills) directory, which holds skills for working with this repository. ## Community - [Discord](https://discord.gg/3tVdM5H8cC) - `#ebitengine` channel in [Gophers Slack](https://blog.gopheracademy.com/gophers-slack-community/) - [GitHub Discussion](https://github.com/hajimehoshi/ebiten/discussions) - [`r/ebitengine` in Reddit](https://www.reddit.com/r/ebitengine/) ## License Ebitengine is licensed under Apache license version 2.0. See [LICENSE](LICENSE) file. [The Ebitengine logo](https://ebitengine.org/images/logo.png) by Hajime Hoshi is licensed under [the Creative Commons Attribution 4.0](https://creativecommons.org/licenses/by/4.0/). Ebitengine bundles third-party libraries. See [NOTICE.md](NOTICE.md) for their licenses. --- ## File: internal/graphicsdriver/metal/README.md These packages are copied from Dmitri Shuralyov's mtl packages and edited with Dmitri's permission: * `github.com/hajimehoshi/ebiten/v2/internal/graphicsdriver/metal/ca` (copied from `dmitri.shuralyov.com/gpu/mtl/example/movingtriangle/internal/ca`) * `github.com/hajimehoshi/ebiten/v2/internal/graphicsdriver/metal/mtl` (copied from `dmitri.shuralyov.com/gpu/mtl`) * `github.com/hajimehoshi/ebiten/v2/internal/graphicsdriver/metal/ns` (copied from `dmitri.shuralyov.com/gpu/mtl/example/movingtriangle/internal/ns`) --- ## File: internal/graphicsdriver/opengl/gl/README.md This is a fork of `github.com/go-gl/gl/v2.1/gl` with the below patch. This is now modified manually. The original version is generated from `github.com/hajimehoshi/glow`'s `nocgo` branch. This enables to remove dependencies on Cgo on Windows. Now we are working on committing this 'no-cgo' change to the official gl package. See https://github.com/go-gl/glow/pull/102. --- ## File: misc/README.md # How to use the images You have to add a note describing that the Ebitengine logo by Hajime Hoshi is licensed under [the Creative Commons Attribution 4.0](https://creativecommons.org/licenses/by/4.0/) somewhere in your application.