Skip to content

Zaczero/teodle

Repository files navigation

Teodle - Guess the rank!

GitHub Pipenv locked Python version Project license Support my work GitHub Repo stars

Teodle is a Python-powered website for Twitch streamer Teo, to watch game clips submitted by his community and guess the ranks. The livestream viewers can also participate in the game by casting their votes in the Twitch chat. The most accurate viewers are displayed on the leaderboard.

Ranking System

The ranking system in Teodle is primarily based on stars, the more stars, the higher the score.

The rules are simple:

  • If you guess the exact rank of a game clip, you get 2 stars.
  • If you are 1 rank off, you get 1 star.
  • Otherwise, you get no stars.

Live Participation

Viewers can play along during livestreams by voting in the chat and competing for both accuracy and speed. The leaderboard showcases the top performing viewers.

Media

Screenshots

YouTube Series

Updated on 30/08/2023

Show more

Deployment

We recommend using Docker for the best experience.

Docker

  1. Install Docker
  2. Clone and enter the repository
git clone https://github.com/Zaczero/teodle && cd teodle
  1. Rename .env.example to .env and configure the environment variables

    1. TTV_TOKEN: Twitch chat access token, get one here.
    2. TTV_USERNAME: Twitch account's username for the token.
    3. TTV_CHANNEL: Twitch channel to listen the chat on.
  2. Build the image

docker build . -t teodle
  1. Start the container
docker run --rm --env-file .env -p 8000:8000 -v $(pwd)/data:/app/data teodle
  1. Access the website at http://localhost:8000

Footer

Contact me

https://monicz.dev/#get-in-touch

Support my work

https://monicz.dev/#support-my-work

License

This project is licensed under the GNU Affero General Public License v3.0.

The complete license text can be accessed in the repository at LICENSE.