Skip to content
Configurable ASCII-Art Hangman game for children with TUI
Branch: master
Clone or download
Latest commit 47449b4 May 13, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode simplify filter Apr 14, 2019
dist update documentation May 9, 2019
doc prepare version 4.7.0 May 13, 2019
.gitlab-ci.yml add travis configuration files May 8, 2019
.travis.yml add travis configuration files May 8, 2019
Cargo.toml prepare version 4.7.0 May 13, 2019
LICENSE link to pdf-rendition updated Feb 4, 2016
make-bin add simple make script May 6, 2019
make-dist refactor directory and file structure May 16, 2018
make-doc add rustdoc May 11, 2019


ASCII Art Hangman for Kids


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

Lives:	7	Last guess: k

 g o o d   l u _ k

Type a letter, then press [Enter]:

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.

In the course of the game ASCII-Art images - designed for children - are progressively disclosed. There are 30 built in ASCII-Art images from which one is chosen randomly at the beginning of the game. Alternatively own ASCII-Art can be provided in the configuration file.

The project is hosted on Github: getreu/asciiart-hangman-for-kids. The project’s webpage is on There you also find a pdf rendition of this document and compiled binaries.



Short instructions

Download .zip file, unpack, find hangman binary, grant execution permissions, open terminal, type ./hangman.

Detailed instructions
  1. Open a terminal window

  2. Download the binary hangman from here.

  3. Extract the contents from the archive

  4. Copy the binary to $PATH

    sudo cp ./dist/bin/hangman /usr/local/bin
    sudo chmod 775 /usr/local/hangman
  5. Generate a sample configuration file in your home directory

  6. Edit the configuration file

    nano hangman-words.txt
  7. Start the game

    Linux version
    Figure 1. Linux version


Short instructions

Download .zip file, unpack, find the .exe binary, grant execution rights, double-click to start.

Detailed instructions
  1. Download the binary hangman from here.

  2. Extract the contents of the archive

    Click right on asciiart-hangman-for-kids.zipExtract all.

  3. Navigate to the hangman binary

    Change into folder ./dist/bin/

  4. Add Read and Execute permissions

    Right click on hangman.exe → Properties → Security → "Everyone" → Edit

    "Everyone" → Add → "Read and Execute" → Ok

  5. Generate a sample configuration file in your working directory

    Double click on hangman.exe

    This creates the file hangman_words.txt

  6. Edit the configuration file

    Double-click on hangman-words.txt. This opens the file in the Notepad editor. Add own secrets, one per line.

  7. Start the game

    Double-click on hangman.exe.

    02 Screenshot Windows


Synopsis and syntax

Sample configuration files

Simple configuration file

guess me
good luck

Simple configuration file with hints

guess me
_good l_uck

Configuration file with custom image

A configuration file may contain a custom image. The image is gradually disclosed after each right guess.

- _guess_ me
- hang_man_
- good luck

|      !!!!\\\\
|    '`!_  ||||
|     ` \`-'''|
|       `\   /
|        )\  \
| ejm   /  \  \
|           \|

# Author: ejm

It is also possible to split the word list and the image into two files and load them separately:

hangman wordlist.txt custom-image.txt

Configuration file with traditional gallows image

The following image has a different rewarding mode: The image is gradually disclosed after each lost life.

- _guess _me
- hang_man_
- _good l_uck

|  ______
|  |    |
|  |    O
|  |   /|\
|  |    |
|  |   / \
||      |___

Play the game

The game is designed for classroom usage, but can be played alone as well.

Classroom requirements

  • Big screen or projector

  • Windows or Linux Computer with hangman.exe or hangman binary installed.

Prepare a configuration file with secret words

The aim of the game is to consolidate recently learned vocabulary. For this purpose the class composes a vocabulary list of words or expressions, hereafter referred to as list of secrets words.

  • The class composes the list of secrets together with the teacher. To optimize the learning progress, it is most useful to involve the pupils in the preparation of the list of secrets, e.g.: One pupil types the suggested words into the configuration file, the others follow at the screen and correct spelling mistakes.

  • The list of secrets can be recent vocabulary or calculation exercises. A secret is always encoded as one line in the configuration file and can be a word or a whole sentence of vocabulary or even a math exercise.

  • To give an additional hint it, is possible to tag a part of the secret sentence. This part will be disclosed immediately when the game starts.

  • When the game starts the computer will choose one secret of the list

  • randomly. The teacher can also as he does not know either.

Game rules

The following rules make sure that the whole class participates.

  1. The whole class is asked to write down all guessed letters on a sheet of paper.

  2. A player can guess again when when the last guess was right, meaning the secret contained the guessed letter.

  3. If not, the next player may try it. In bigger groups the next player should be chosen randomly. This incites the whole group as nobody knows who will be the next.

  4. A player is not allowed to ask others to remind him if a letter was already tried or not. He has to solely rely on his own notes.

  5. The winner of the game it the person who discloses the last letter of the secret word.

Start the game


  1. Open a terminal

  2. Navigate to a folder containing configuration files, e.g.

    cd vocabulary-chapter-1
  3. If the folder contains only one configuration file hangman-words.txt just type


    otherwise type, e.g.

    hangman words-page3.txt words-page5.txt


  1. Open the folder where the hangman.exe file resides.

  2. Open a second explorer window and navigate to a folder with a configuration file.

  3. Drag and drop one or more configuration files on hangman.exe.

You can’t perform that action at this time.