Getting Started
Follow these simple steps to get up and running.
1
Install the TCG Timer Server
Select your platform below to download and get installation instructions.
Download for Windows (.exe)
- Run the downloaded installer.
- Launch TCG Timer from your Start Menu or Desktop shortcut.
- Install Git:
sudo apt-get update
sudo apt-get install git-all
- Clone GitHub repo:
git clone https://github.com/starg33kertcg/TCG_Timer.git
- Change directory to TCG_Timer/app_files/ and update app.py with your own secret key:
cd TCG_Timer/app_files
sudo nano app.py
app.secret_key = 'YOUR_KEY_HERE' # Replace with a stronger secret key for session management
- Go back to TCG_Timer/ and update setup.sh with execute permissions:
cd ..
sudo chmod +x setup.sh
- Run the setup script (Installs python, nginx, and gunicorn. Configures reverse proxy, firewall, permissions, services, and app parameters):
sudo ./setup.sh
- When completed, access the viewer at
http://SERVERIP
and the admin panel athttp://SERVERIP/admin
- Install Docker and Docker Compose (run docker-install.sh on my GitHub repository to automate this process):
# Update package list and install prerequisites
sudo apt-get update
sudo apt-get install -y ca-certificates curl
# Add Docker's official GPG key
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
# Add the Docker repository to Apt sources
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
# Install Docker Engine, CLI, and Compose
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - Install Git:
sudo apt-get install git-all
- Clone the Docker TCG Timer repository:
git clone https://github.com/starg33kertcg/TCG_Timer_Docker.git
- Disable apache2 (installs with git):
sudo systemctl stop apache2
sudo systemctl disable apache2
- Update .env file with your own secret key and 5-digit numerical PIN:
cd TCG_Timer_Docker
sudo nano .env
# Your secret credentials
# Generate a new one for production, e.g., by running: python3 -c 'import secrets; print(secrets.token_hex(24))'
SECRET_KEY='YOUR_KEY_HERE' # Replace YOUR_KEY_HERE with your own secret key
ADMIN_PIN='12345' # Replace with your 5-digit PIN - Build the app image:
sudo docker compose build
- Start the services:
sudo docker compose up -d
The TCG Timer Server is required for core functionality. The Roku app is the Timer Viewer only. You may choose to install the Windows or Linux server using the tabs above.
Go to Roku Channel Store- From the link above, add the TCG Timer channel to your Roku device (or search for TCG Timer).
- Launch it from your Roku home screen.
- Enter your TCG Timer server IP followed by a colon : and appropriate port number. (:5000 for Windows, :80 for Linux, and :8080 for Linux w/ Docker)
2
Configure the Timer
Once installed, access the Admin Dashboard.
From the Admin Dashboard, you can:
- Enable or disable the timers.
- Set the round time (e.g., 50 minutes).
- Start, pause, resume, or reset a timer.
- Set a Low Time Warning or disable it entirely.
- Set a background and font color.
- Upload logos of your favorite TCGs (e.g., "Pokémon™", "Yu-Gi-Oh!™", "Magic: The Gathering™")
That's it!
You're ready to host your first timed match.