[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Employee Timeclock

Badge-scan timeclock kiosks for ERPNext and HRMS, with a daily punch record per employee and job-card time tracking for the shop floor.

[Open source](/open-source/)

Employee Timeclock

Frappe & ERPNext
Active
MIT

[View on GitHub (opens in a new tab)](https://github.com/Avunu/employee_timeclock)[Documentation (opens in a new tab)](https://docs.avunu.net/employee-timeclock/)

PlatformFrappe & ERPNext

LicenseMIT

StatusActive


Repository[Avunu/employee_timeclock](https://github.com/Avunu/employee_timeclock)

Part of

Used in

Paper time cards and shared logins make payroll slow and hard to trust. Employee Timeclock puts a kiosk on a tablet or PC by the door: employees scan their badge to clock in and out, and the punches land in ERPNext as Employee Checkins. On the shop floor, the same badge starts and stops timers on Job Cards, so labor hours reach your job costing without anyone re-keying them. It needs ERPNext and HRMS.

## Features

**Kiosk pages.**
 A badge kiosk at 
`/timeclock`
, an Employee Clock-in/out web form, and a job time tracker at 
`/job_timeclock`
. Each runs signed in as a kiosk user with the Timeclock Kiosk role; none accept guests.

**Badges.**
 HR issues a random badge token from the Employee form and prints it as a barcode or QR code; only its SHA-256 hash is stored. Reissue or revoke it at any time. RFID tags in the Employee's Attendance Device IDs work too.

**Workdays.**
 Each employee's punches for a day are gathered into one Workday record with up to twelve in and out pairs and the total hours. Edits on either side keep the Workday and its Employee Checkins in step.

**Job time tracking.**
 Employees pick a work order and operation and start a timer that logs to the Job Card. Starting a new job closes the open one. Operations marked as machine time track the machine separately from its operator, and employees can pin the jobs they use most.

**HR tools.**
 The Workday Management page flags missing punches, duplicate or out-of-sync workdays, and lets HR add, fix, or delete punches in bulk. Payroll, hours, and punch list reports cover the rest.

**Safe by default.**
 Only active employees can clock in, badge scans are rate limited per client, and an unknown badge gets the same answer whatever the reason.

## Getting started

Install the app on a site with ERPNext and HRMS, create a kiosk user with only the Timeclock Kiosk role, issue badges from each Employee's 
**Timeclock**
 menu, and sign the kiosk device in. The 
[README](https://github.com/Avunu/employee_timeclock#setting-up-a-kiosk)
 walks through each step.

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">bench</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">get-app</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">https://github.com/Avunu/employee_timeclock</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">bench</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">--site</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E"><</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">SITE_NAM</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">E</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">install-app</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">employee_timeclock</span>
```

Highlights

Clock in and out at a kiosk by scanning a badge or RFID tagOne Workday record per employee per day, kept in sync with Employee CheckinsJob timers that log time to Job Cards, including machine timeWorkday Management page and payroll reports for HRBadges stored only as hashes, scans rate limited, no guest access

Related projects

[All open-source projects](/open-source/)

[ERPNext TaskView](/open-source/erpnext_taskview/)

Active&#xA;

A project and task workspace for ERPNext, with timers and hour budgets for staff and a portal where customers follow and work on their projects.

MIT[GitHub](https://github.com/Avunu/erpnext_taskview)

[ERPNext CIS Plus](/open-source/erpnext_cis_plus/)

Stable&#xA;

Simpler customer, contact, and address management for ERPNext, with address validation, geolocation, and a map of your customers.

MIT[GitHub](https://github.com/Avunu/erpnext_cis_plus)

[Automated Subscriptions](/open-source/automated_subscriptions/)

Active&#xA;

Automatic billing for ERPNext Subscriptions, with payment requests, billing anchors, proration, consolidated invoices, and credit notes.

MIT[GitHub](https://github.com/Avunu/automated_subscriptions)

Need help with it?

Need this implemented? Our ERPNext implementation team can set up kiosks, badges, and payroll reporting for your team.

[Explore ERPNext implementation](/services/erp/erpnext/)[Start a project](/start/)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)