#ascii #game #desktop #hangman

app ascii-hangman

customizable Hangman game with ASCII-art rewarding for children (desktop version)

7 stable releases

5.2.2 Aug 31, 2020
5.2.1 Jul 8, 2020
5.1.0 Jun 27, 2020
4.10.3 Jun 25, 2020
4.10.0 Mar 26, 2020

#47 in Text processing

Download history 4/week @ 2020-06-01 12/week @ 2020-06-08 5/week @ 2020-06-15 49/week @ 2020-06-22 32/week @ 2020-06-29 21/week @ 2020-07-06 19/week @ 2020-07-13 17/week @ 2020-07-20 7/week @ 2020-07-27 24/week @ 2020-08-10 8/week @ 2020-08-17 10/week @ 2020-08-24 12/week @ 2020-08-31 36/week @ 2020-09-07 1/week @ 2020-09-14

75 downloads per month


1.5K SLoC

title: ASCII-Hangman - hangman game for children with ASCII-art rewarding

Cargo Documentation License

A little game designed for primary kids to revise vocabulary in classroom. Setting up the vocabulary list is part of the learning process.

Hangman is a paper and pencil guessing game for two or more players. One player thinks of a word, phrase or sentence and the other tries to guess it by suggesting letters or numbers, within a certain number of guesses. In this version for children the computer selects a word, phrase or sentence randomly out of a word-list defined in a configuration file. As a reward, with every guessed letter, some ASCII-art is gradually disclosed.


        ,' /, )_____
     __j o``-'
          |_\  |--^.
         /_]'|_| /_
            /_]'  /

Lifes:	7 	Last guess: k

 g o o d   l u _ k

Type a letter, then press [Enter]:

ASCII Hangman is available as a Web-Application and as a Desktop-Terminal-Application for several architectures. Try ASCII-Hangman-Web-App online.


  • simple, non distracting user interface,
  • setting up word lists is part of the learning process,
  • visual non distracting reward system with 50 built-in ASCII-art images,
  • no built in traditional gallows image,
  • designed for group learning in classroom,
  • fully configurable:
    • design own ASCII-art (depending on the learning subject) and associate it to a word list,
    • provide the user with hints by disclosing some characters from the start,
  • web-application: play without installation,
  • desktop versions: play without network access,
  • open source software: guaranteed availability, always free of charge.

The first versions of ASCII-hangman were published as desktop versions only. With the rising of cyber-crime and the following security related restrictions, it became more and more difficult for teachers to install their own software. This is why from version 5.0 on, ASCII-hangman is also available as web-application.

Read more in ASCII-Hangman's user manual.


User documentation:

Developer documentation:

Source code



ASCII-Hangman web application

As the ASCII-Hangman-Web-App is hosted on https://getreu.net, there is nothing to install. Just follow the link and enjoy playing: ASCII-Hangman-Web-App

ASCII-Hangman desktop version

Building and installing

This section describes how to download and build the desktop version of ASCII-Hangman.

  1. Install Rust, e.g.

    curl https://sh.rustup.rs -sSf | sh
  2. Download, compile and install:

    cargo install ascii-hangman
    sudo cp ~/.cargo/bin/ascii-hangman /usr/local/bin

    See also the user manual for a more detailed installation description.

This project follows Semantic Versioning.



  • Jens Getreu


  • Apache 2 licence or MIT licence


~50K SLoC