Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Ascii Patrol is an ASCII game project. It was mainly inspired by "Moon Patrol", my favourite arcade game at the times I was a child.


Currently game can be built using C++ compilers such as Clang, GCC, or Intel oneAPI including operating systems:

  • Windows (Visual Studio, Cygwin, MinGW, MSYS2, Windows Subsystem for Linux)
  • Linux, MacOS
  • DOS (Watcom)
  • HTML5 browsers (Emscripten)

Version 1.7

  • Added $ASCII_PATROL_CONFIG_DIR and $ASCII_PATROL_RECORD_DIR environment variables (Linux only)

Version 1.6

Version 1.5

To use / modify / add graphics asserts located in 'asset' directory you need to use REXPaint Copy 'assets' directory to REXPaint's 'images' subdirectory. To apply modifications to the game, in next step you should use temp_xp program which converts all .xp files located in some directory to assets.cpp and assets.h files being compiled with game.

Ascii Patrol Home Page (

Accordingly to AP can be easily built and runs great on Raspberry PI!

Find me on Twitter: @MrGumix

Give it a try on any HTML5 browser

Quick install on Linux with snap

Get it from the Snap Store
snapped by @popey

  • sudo snap install ascii-patrol


Arch Linux:

Build instructions

These instructions assume the system has Git and a C++ compiler.

# clone sources repo
git clone

# enter sources directory
cd ascii-patrol


The needed libraries are installed like:

# install required packages, (no apt-get -> use pacman)
sudo apt-get install libx11-dev libpulse-dev
# OR
sudo dnf install libX11-devel pulseaudio-libs-devel

# to fix problems with no keyboard input in few gnome terminals we require XI2
sudo apt-get install libxi-dev
# OR
sudo dnf install libXi-devel

Build with CMake:

cmake -Bbuild
cmake --build build

If the system doesn't have CMake:

# enable execution of and scripts
chmod +x *.sh
# invoke compilation


Homebrew install libraries (works with Clang or GCC):

brew install libx11 libxi pulseaudio


cmake -Bbuild
cmake --build build


No extra libraries are needed on Windows. Works with Visual Studio, MinGW / MSYS2, Cygwin, or WSL.

cmake -Bbuild
cmake --build build


On a system with emscripten installed, build for HTML5 web browsers, producing "build/asciipat.[js,wasm]"

emcmake cmake -B build -Dweb=on
cmake --build build


Ascii Patrol uses curl to communicate with hi-score server ( So optionally let's install it if needed. sudo apt-get install curl

Finally let's piu-piu ! ./asciipat or ./

More on asciipat arguments can be found here:


Ascii Patrol creates two files: asciipat.cfg and asciipat.rec.

asciipat.cfg is created when you change your player name, avatar, or key bindings. asciipat.rec is created when you start playing the game, and get a score.

On Linux, by default, the game saves these files in $HOME. If $HOME is not set, then the game saves the files in the current directory.

However, if $ASCII_PATROL_CONFIG_DIR or $ASCII_PATROL_RECORD_DIR are set, then the game will save the files in those directories respectively. The directories should already exist; Ascii Patrol will not create them.


  • no sound? -> install / start pulseaudio ( ie: pulseaudio -v -C )
  • weird colors? -> try another terminal emulator or run from raw console (ctrl-alt-F1 or so)
  • poor font look? -> try changing font in your terminal or in case of raw console use setfont
  • keyboard doesn't work? -> try another terminal emulator or run from raw console
  • no hi-scores table? -> install curl


Ascii Patrol is an ASCII game project. It was mainly inspired by "Moon Patrol", my favourite arcade game at the times I was a child.







No packages published