Repository navigation
v0.1.0 — first production-verified release
Turn any Android tablet into a wall-mounted punch clock for Frappe HR.
This milestone marks the first production deployment: a wall-mounted Samsung Galaxy Tab A11+ running the kiosk in FreeKiosk Device Owner mode — badge scans read in well under a second via the front camera.
Highlights
- Clock-first dark terminal UI — big server-synced clock (the display can never disagree with the recorded time), initials avatars, live presence
- QR badge scanning with the device camera + an always-available PIN path; automatic IN/OUT toggle with a 5-second undo
- Privacy by default — the camera scans without showing its image
- Device token auto-login — kiosk hardware heals itself after reboots, no credentials on the device
- Badge management on the Employee form: encrypted PINs, revocable UUID badges, printable card labels
- Admin workspace with who's-in board, number cards and a working-hours chart
- German/English UI, confirmation sounds, HRMS Auto Attendance integration out of the box
- Test suite + CI, and a battle-tested FreeKiosk device-owner setup guide incl. the Google ghost-account trap
All punches are standard Employee Checkin records — attendance, timesheets and payroll just work. No proprietary hardware, no forked doctypes. GPL-3.0.
