Skip to content


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation


Azimuth is a metroidvania game, with vector graphics. You can build it from source here, or download binaries at

Azimuth is inspired by such games as the Metroid series (particularly Super Metroid and Metroid Fusion), SketchFighter 4000 Alpha, and Star Control II (a.k.a. The Ur-Quan Masters) -- all fine games that are well worth your time.

Build instructions


Azimuth depends on OpenGL and on SDL2. On Mac, you can install SDL2 either in Framework form or via e.g. Homebrew or MacPorts, and the Makefile should be able to sort it out. On Debian, all it should take is:

$ sudo apt-get install libgl1-mesa-dev libsdl2-dev

Building and running

To build and run a debug build of the game, run:

$ make       # Compiles everything.
$ make test  # Runs unit tests, to make sure things look okay on your system.
$ make run   # Starts the game.

To build and install a packaged app on Mac OS X, run:

$ BUILDTYPE=release make macosx_app
$ mv -i out/release/host/ /Applications/
$ open /Applications/

To build and install a packaged app on Debian, run:

$ BUILDTYPE=release make linux_deb
$ sudo dpkg -i out/release/host/azimuth_*.deb
$ azimuth


SDL_SetVideoMode failed: Couldn't find matching GLX visual

This error seems to occur on some older Linux machines. One thing you can try is to edit src/azimuth/gui/screen.c and comment out the following lines before recompiling:


This will disable antialiasing, so the graphics might not be 100% correct, but the game should still be perfectly playable.


This codebase is licensed under the GNU GPL, version 3. This codebase is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Azimuth is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The complete license can be found in the LICENSE file.


Additionally, the music for Azimuth (found in the data/music directory) may optionally be used under a Creative Commons Attribution 4.0 (CC-BY 4.0) license. When attributing, I'd appreciate it if you would link back to or to this repository.