Skip to content

Repository files navigation

TimeKeeper

A time tracking and sign-in management system built for FRC (FIRST Robotics Competition) teams. Track team member attendance across sessions and locations with support for RFID check-in/out (PCSC or keyboard emulation), Discord integration, and multi-platform clients and servers.

Conceptualised from other attendance systems like 254's Cheesy Hours and 3132's Attendance systems. Built to be generic and easy to setup with minimal overhead and no external requirements, using an embedded key-value db and simple 3rd party API integrations.

Features

  • Session Management - Create and manage timed sessions at configurable locations
  • RFID Check-In/Out - Supports both PCSC smart card readers and keyboard-emulating RFID readers
  • Kiosk Mode - Dedicated fullscreen mode for check-in stations
  • Discord Bot - Session reminders, attendance commands, leaderboards, and member name syncing, self checkouts
  • Schedule Import - Import sessions from CSV or ICS (iCalendar) files
  • Multi-Platform Clients - Desktop (Linux, Windows, macOS), Android, and Web
  • Real-Time Sync - gRPC streaming keeps all connected clients in sync

Quickstart

  1. Download the server from the latest release
  2. Run it on a device of your choice (cloud server, local, rpi etc...)
  • Note: (Run the command server.exe --help for start config commands. I.e server.exe --web-port 80)
  1. Navigate to the servers address using the set port or default port 8080. I.e (http://10.128.22.120:8080)
  2. Login using the button in the top right of the app bar (default username admin, default password admin)
  3. Using the left rail navigation bar enter the setup page and configure the setup (import ICS or CSV calendar, student and mentor data, notifications etc...)
  • Note: Connect to discord first and import users through discord to pre-link their accounts in the system for later use if using discord

Documentation

Check documentation for more details.

About

Time Management System (TMS lol). Team kiosk & time keeping

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors