GeoPunch

GeoPunch

Automatic punch in/out for your OrangeHRM server when you arrive at work.

This is the public home of GeoPunch for Android: bug reports, feature requests, questions and release notes. The app’s source code is not published here.

This application is an independent third-party tool and is not affiliated with, endorsed by, sponsored by, or associated with OrangeHRM Inc. in any manner. “OrangeHRM” is a trademark of its respective owner and is used here only to describe the server software the app connects to.

What it does

GeoPunch punches you in when you arrive at work and out when you leave, straight into your company’s self-hosted OrangeHRM 5 system. When you arrive, it asks “Punch in?” with a short countdown, so you can confirm, adjust the time or cancel. When you leave, it waits a grace period you choose before proposing a punch-out, timed at the moment you actually left. There is no GeoPunch account or cloud service: the app talks only to your company’s server.

Home Confirm punch Monthly attendance Leave
Home screen, punched in on site Automatic punch-in confirmation with countdown Monthly attendance with daily and weekly totals Leave balances and requests
Work site Attendance log Attendance rules
Work site editor with map and geofence radius Attendance log with sync status Attendance rules

Features

Get the app

Get it on Google Play

GeoPunch is on Google Play. While the closed test runs, the store page opens only for enrolled testers: to join, email alkaes@gmail.com with the Google account you use on your phone. Don’t post that address in an issue: issues are public.

Requirements:

Report a problem or suggest a feature

From the version after 1.2, Settings → About & Legal → Report a problem in the app opens the bug report with your app version and phone already filled in.

I want to… Use
Report something that doesn’t work Bug report
Say the app can’t sign in or sync with my server Server compatibility
Ask for a new feature or a change Feature request
Report a translation mistake or offer a new language Translation
Report a security vulnerability Not an issue: see SECURITY.md

Before opening an issue, search the existing issues and add a 👍 to the one that matches instead of opening a duplicate. Votes are how feature requests are prioritised.

Keep private data out of issues

Everything here is public. Never post:

“A self-hosted OrangeHRM 5.6 on HTTPS behind nginx” is all the server detail an issue needs. If a problem can’t be described without private details, say so in the issue and email them instead.

Frequently asked questions

Does GeoPunch track my location in the background? No. Location is read only while the app is open or while its monitoring notification is showing, and positions are compared with your work sites on the phone. The app never sends your position to your server or to the developer. See the privacy policy.

The app didn’t punch me in when I arrived. Check the status strip on Home: monitoring stopped, notifications off, a day off or holiday, leave, or outside the automatic punch-in time window all prevent it on purpose. Some phones (Samsung, Xiaomi, Huawei and others) stop apps aggressively: set GeoPunch’s battery usage to Unrestricted. If none of that explains it, open a bug report.

My punch failed with “time refused”. Your server only accepts punches at the current time. Ask your administrator to enable “Employee can change current time when punching in/out” if you want to confirm punches with an adjusted time.

Does it work with OrangeHRM 4, OrangeHRM Starter cloud or another HR system? GeoPunch is built for OrangeHRM 5.x. If you have a different setup, open a server compatibility issue; it helps decide what to support next.

Is there an iPhone version? Not yet. If you want one, add a 👍 to the iOS feature request, or open it if it isn’t there.

Release notes

See CHANGELOG.md and the Releases page.

Contact

alkaes@gmail.com, for anything that doesn’t belong in a public issue.

Privacy policy: https://alkaes.github.io/GeoPunch/privacy/

Google Play and the Google Play logo are trademarks of Google LLC.