Penn State ACM Check-in
shanetully.com & acm.psu.edu
Note: An actively maintained fork of this project exists at http://clemsonmakerspace.github.io/Magstripe_Attendance/.
The Penn State ACM Check-in is a Python 2.x application. There are two dependencies:
PyQt- Python bindings for QT
MySQLdb- Python MySQL library
To actaully use it, however, you will need a database server (either a remote server or hosted locally).
The default host, database, table, and host are configurable in the
Constants.py module or are able to
be entered in the login screen of the application.
For the database, this application expects a table with four columns:
- card ID - card ID from ID card (
- access ID - human-readable owner of card (
- points - the number of points (
- last check-in - the time of last check-in (
You'll probably want to change the default database information for your database in
Finally, the whole script is pointless without a card reader. This application was built for a card read that uses keyboard emulation. Hence, you could just type the card info in, but without a card reader you have no way of knowing what that info is.
Simply run "./Check-in.py" to start the GUI.
There is also a text-only mode. This can be started by using the "--nogui" argument. In text mode, enter "back" at any time to go up a menu level or exit the check-in loop.
To populate your database, select the check-in option and if a card doesn't exist in the database you will be prompted to add it.
After your database is populated you can use the "Show Points" option to show a single user's points or view a pretty table of all users in descending order from most to least points.
Note that, by default, a card is only allowed to check-in once per hour to prevent abuse. This can
be disabled by setting
A PyInstaller .spec file is provided to package the program and all dependencies into a single binary file for Linux, Windows, or Mac.
To create this binary, download PyInstaller and run
make.py dist [path to pyinstaller]. The resulting binary will be in the
Alternatively, precompiled binaries are available on the releases page on the GitHub repo.
Copyright (C) 2013 Shane Tully
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/.