,' /, )_____
     __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

Usage: hangman
       hangman [FILE]...
       hangman -h|--help
       hangman -V|--version

[FILE] are configuration files containing word-lists and optionally Ascii-Art images.

When no [FILE] argument is given, [FILE] defaults to hangman-words.txt. In case no [FILE] is found, a template configuration file hangman-words.txt is written into the current working directory. Multiple `[FILE]`s are concatted.

[FILE] is an UTF-8 file containing 4 different line-types:

  • lines starting with a letter, a digit or '-' are secret strings. At the beginning of the game one line is randomly chosen and all characters are hidden. If you want to give an additional hint, enclose some characters with _. The enclosed is then displayed in clear when the game starts. For example the configuration line:

    Guess _me_
    is shown in the game as:
    _ _ _ _ _ _ m e
  • lines starting with # are ignored. This can be used for comments.

  • lines starting with | are part of an optional custom Ascii-Art image shown progressively in the course of the game. If not defined here, built in Ascii-Art images are used instead.

  • lines starting with : are game modifier. They change the logic how the image is progressively disclosed:

    `:success-rewarding`       Every guessed character shows a bit more of
                               the image. This mode is default.
    `:traditional-rewarding`   Every lost live discloses a bit more of the
                               image. Choose this mode together with a
                               traditional gallows image (not built in).

The following shows an example of a custom image (copy it left-aligned into the config-file):

|  ,~~--~~-.
| +      | |\
| || |~ |`,/-\
| *\_) \_) `-'

If you prefer a traditional gallows image, add the following:

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

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.