🤖 Explain with AI

FaceID kiosk¶

The 4Geeks Payroll FaceID kiosk turns an Android tablet into a touchless attendance terminal. Employees clock in and out by looking at the camera — no cards, no PINs.

It runs fully on-device: face detection and matching happen on the tablet, and clock events sync to 4Geeks Payroll automatically.

Before you start¶

1. Employees need photos. Upload at least 3 usable photos per employee in the console (employee profile → Photos tab). See employees.
2. Create a station. In Payroll → Stations, create a station whose name will be the kiosk’s device ID. See stations.

Configure the kiosk¶

1. Install and open the kiosk app on the tablet. If it is not configured, it shows a Device Not Configured screen.
2. Tap Configure Device (or tap the device-ID bar at the bottom at any time).
3. Enter the Device ID — use the station name (or a configured device ID). The kiosk resolves it against your company and downloads the employee gallery.
4. The kiosk shows Synchronizing employees… while it downloads photos and computes face templates. This can take a while for large teams.

The device ID must match a station name or a registered device, otherwise the kiosk cannot sync.

Daily use¶

1. An employee stands in front of the camera.
2. The kiosk detects the face, checks its position and quality, and matches it locally.
3. On a match, it shows the employee’s name and a CLOCK IN or CLOCK OUT badge and plays a confirmation sound.
4. If the same person is recognized again within a minute, it shows Already registered and does not create a duplicate event.

The screen displays a SENSOR STATUS indicator (Active/Ready, Processing, Success, Error) and guidance messages such as “Move a little closer”, “Move toward the light” or “Keep your head straight” when the face is not usable.

Offline operation¶

• Face recognition works without internet.
• Clock events are stored on the device and synced automatically when the connection returns. While offline, the kiosk shows “Recorded (offline). Will sync automatically.”
• Employee data refreshes periodically and on demand.

Updates¶

The kiosk installs new versions from the published APK releases, without a cable:

• It checks for a new version every 24 hours and retries if the check fails.
• Check for update, next to the device ID in the bottom bar, runs a check on demand.
• Update Available appears when a release is ready and can be postponed for 5 minutes.
• A mandatory release shows a countdown and cannot be skipped. If the installer fails, the kiosk keeps working and can retry.

Recognition accuracy and speed¶

• Same pipeline for enrolment and recognition: the photos used to enrol and the live frames go through the same preparation, and a match needs the majority of the recent frames, so a single bad frame does not register anyone.
• Multi-face guard: enrolment rejects a photo where more than one face is detected.
• Calibrated match band: the strong-match threshold is calibrated with real kiosk telemetry to reduce false positives.
• Speed: frame processing is down from about 2 seconds to roughly 150 ms, with a short cooldown between attempts.
• Instant IN/OUT: the kiosk predicts CLOCK IN or CLOCK OUT from the previous event and confirms it with the server response; a pending dot shows the prediction until the server answers.
• Device language: the interface follows the tablet language (English, Spanish and Portuguese).
• Diagnostics: match attempts and a heartbeat reach 4Geeks Payroll for support; photos, crops and embeddings stay on the device.

Troubleshooting¶

Related¶

• Stations
• Employees and contractors
• Time tracking

Still have questions? Ask on Discord or explore the tutorials.