ashwinjv/buzzer

A little buzzer app for running your own quizzes or game shows!

A little buzzer app for running your own quizzes or game shows! Uses websockets to sent messages.

Based on https://github.com/bufferapp/buzzer

Running the app

You'll need Node.js or Docker to run this application. For Node:

npm install
node index.js

For Docker:

docker build -t buzzer .
docker run -p 8090:8090 buzzer

Open http://localhost:8090 in your browser to start!

How to use

The players goto the homepage (http://localhost:8090/) and they can enter their name and team number. Joining will give them a giant buzzer button!

The host heads over to /host and will be able to see everyone that buzzes in and clear the list in between questions.

Join a team	Buzz in	Host view

How to deploy to EC2

This repo comes setup with all the scripts needed to deploy the app using Lets Encrypt if you have a domain that you own

1. Launch an EC2 instance in AWS (a t2.micro should be sufficient)
2. Setup the security group to allow access from anywhere in ports 80 (HTTP) and 443 (HTTPS)
3. Setup the DNS settings for your domain/domains to point to the EC2 instance public IP
4. SSH into the EC2 instance and install git

   sudo yum install -y git
   

5. Clone this repo

   git clone https://github.com/ashwinjv/buzzer
   

6. Add your domains and email addresses to init-letsencrypt.sh
7. Run the script

   ./init-letsencrypt.sh
   

The buzzer app should now be at https://<domain-name>

License

MIT