Tingo is a web application built to manage teacher bingos. It uses technologies like AngularJS, lesscss and the Spring Framework. Also check out sic, which is a citation management software.
Specifically, Tingo allows anyone knowing a secret code to register, view and manage bingo fields. Teachers do currently have to be created by an administrator, but this might change in the future. It also provides a convenient print view which allows people to print Tingo fields for playing.
Print a grid of Tingo fields for a teacher. Each filed represents something (dumb?) they often do. Once they do that, you mark that field using a pencil. If you have five marked fields in a vertical, horizontal or diagonal row, you win. If you prefer, you can stand up and tell the rest of the class by shouting "Bingo!". Then erase the marks you made and start over again.
Obviously, the game is most fun when played with friends. You can cooperate on creating the fields and also play together. The fields are printed in random order to prevent everyone winning at the same time.
Tingo can obviously be used for things different than teachers, such as TV shows, politicians, university professors, anything. Use your imagination.
To install Tingo, you first need to build it: (assuming you're on GNU/Linux, other platforms work similarly)
git clone https://github.com/literalplus/tingo.git
cd sic
./gradlew build
cp application.yml-default application.yml
Then, you need to edit the application.yml
config file with your favourite editor and insert database credentials.
Tingo was built for use with MySQL or MariaDB. You do not need to perform any database setup except for creating the
database you named in your config file. (tingo
by default)
You can then run the application either using Gradle directly:
./gradlew bootRun
or by running the .jar
file created in the build/libs/
directory.
It will start on port 8080 by default.
docker build -t images.lit.plus/tingo:latest .
docker push images.lit.plus/tingo:latest
helm install tingo charts/tingo --namespace=tingo-sic
This project is licensed under the Apache License, Version 2.0. You can find a copy in the LICENSE
file.
Please, just open an issue at GitHub. Pull Requests are obviously welcome.