#ascii #game #desktop #ascii-art #hangman

app ascii-hangman

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

11 stable releases

5.6.0 Sep 29, 2020
5.5.0 Sep 28, 2020
5.2.2 Aug 31, 2020
5.2.1 Jul 8, 2020
4.10.0 Mar 26, 2020

#65 in Text processing

Download history 23/week @ 2020-07-23 16/week @ 2020-08-06 8/week @ 2020-08-13 9/week @ 2020-08-20 20/week @ 2020-08-27 37/week @ 2020-09-03 1/week @ 2020-09-17 58/week @ 2020-09-24 22/week @ 2020-10-01 3/week @ 2020-10-08 15/week @ 2020-10-15 19/week @ 2020-10-22 21/week @ 2020-10-29 13/week @ 2020-11-05

69 downloads per month

MIT/Apache

120KB
4K 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. ASCII-Hangman comes with a library containing more than 300 different built-in ASCII-art images.

ASCII-ART HANGMAN FOR KIDS

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

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.

Highlights:

  • 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.

Documentation

User documentation:

Developer documentation:

Source code

Repository:

Distribution

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.

About

Author:

  • Jens Getreu

Copyright:

  • Apache 2 licence or MIT licence

Dependencies

~2–3MB
~65K SLoC