Mobile App Guide

The MAttendance mobile app is the primary way most employees will punch in and out, view attendance history, apply for leave, and check payroll. This guide covers everything from installation to troubleshooting.

1. Install the App

1. Open the Google Play Store on your Android phone.
2. Search for "MAttendance".
3. Tap Install.

2. Log In

Using Email and Password

1. Enter your work email address (the one HR registered you with).
2. Enter your password (you received a temporary password in the welcome email — change it after first login).
3. Tap Log In.

Using Google Sign-In

1. Tap Continue with Google.
2. Select your Google account and grant the required permissions.

3. Granting Required Permissions

Grant these permissions when prompted — they are required for specific punch methods:

4. Daily Punch Flow

Standard Punch (Manual)

1. Open the MAttendance app. The Home screen shows your current status.
2. Tap the large Punch button.
3. Select your punch method (GPS, WiFi, QR Code, etc.).
4. Complete the method-specific step (allow location, scan QR, take selfie).
5. A confirmation appears: "Punch recorded successfully."

Automatic Punch (Geofence Auto)

If your admin has enabled Geofence Auto — no action needed. When you enter the office geofence, the app punches you in automatically and sends a notification: "Auto punch recorded — Clocked In at [Office Name]".

5. Viewing Your Attendance

Today's Status

The Home screen shows your current status (In / Out / On Break), time of last punch, total hours worked today, and shift start/end times.

Attendance History

Tap History or My Attendance in the bottom navigation to see a color-coded calendar. Tap any day to see full punch details.

6. Breaks

If your organization has configured break tracking:

1. During your shift, tap Break Start on the Home screen.
2. Select the break type (Lunch, Tea, Short Break) if prompted.
3. When you return, tap Break End.

Break time is tracked separately and may affect your total work hours for the day.

7. Apply for Leave

1. Tap Leave in the bottom navigation.
2. Tap Apply for Leave.
3. Select Leave Type, From Date, To Date, and optionally a Reason.
4. Tap Submit.

Your request goes to your manager/HR for approval. You receive a push notification when it is approved or rejected.

Checking Leave Balance

Tap Leave → My Balance to see days remaining for each leave type, days used this year, and pending requests.

8. Notifications

9. Troubleshooting

Common Issues

• Punch Failed — "GPS punch requires latitude and longitude": Enable Location, go outdoors or near a window, wait 10–15 seconds for GPS lock.
• Punch Failed — "Unregistered WiFi network": Connect to the correct office WiFi. If the issue persists, contact admin — the router may need re-registration.
• Geofence auto-punch within 5 minutes: Normal — the system prevents duplicates. Wait 5 minutes.
• QR Code not scanning: Ensure camera focus, increase screen brightness on the display device, grant camera permission.
• App crashes: Force close and reopen, check for Play Store updates, or uninstall and reinstall (data is stored on the server, not the device).
• Forgot to punch: Go to My Attendance → [Date] → Request Correction. Requires manager/HR approval.
• Session expired: Tokens expire after inactivity for security. Simply log in again — your data is unaffected.

10. For Admins: Distributing the App

When adding new employees, their welcome email includes a Play Store link and their temporary login credentials. You can also share the Play Store link directly via messaging apps.

Managing Employee Devices

• A phone is registered to the employee automatically the first time they log in to the app on it.
• If an employee changes or loses their phone, they simply log in on the new one — it is registered in the same way.
• A punch from a phone that is not registered to that employee is still accepted, but is flagged, and the nightly Device Change check reports employees who punch from unusual devices (see AI Anomaly Detection).

MATTENDANCE QUICK START
1. Download: Play Store → MAttendance
2. Log in with your work email
3. Grant: Location, Camera, Bluetooth
4. Tap PUNCH → select method → done

Punch IN when arriving
Punch OUT when leaving

Problems? support@mattendance.com

11. History: Payslips, Regularization & WFH

The History tab brings together everything about your past attendance:

12. Offline Mode

If you have no internet when you punch, the app saves the punch on your phone and shows "No internet — punches saved locally". Saved punches wait in a queue and are sent automatically when the connection returns.

• Open Offline Mode to see the queue and today's punches.
• Tap Sync now to send them immediately once you are back online.
• A punch marked Failed can be sent again with Retry.

13. Face Enrollment

Before you can use the Face Recognition punch, enroll your face once:

1. Go to Settings → Face Enrollment.
2. Hold the phone in good lighting and look straight at the camera, without tilting your head.
3. Capture. You will see "Face enrolled successfully!" and the enrollment date.

Enrolling again replaces your previous face data — do this if recognition starts failing (new glasses, beard, etc.).

14. Auto-Punch Settings (Geofence & WiFi)

Geofence Auto-Punch

Under Settings → Geofence Auto-Punch, turn on Enable Auto-Punch. Entering the zone punches you in; leaving it punches you out. The screen checks four things and shows Fix next to any that need attention:

• Location Services are on
• Location Permission is set to Allow all the time (background location)
• Battery Optimization is off for MAttendance
• Notifications are allowed

Geofence Places lists the office zones and client sites that will trigger an automatic punch. These zones are used only to decide when to punch.

WiFi Auto-Punch

Under Settings → WiFi Auto-Punch, turn on Enable WiFi Auto-Punch to record attendance automatically when your phone connects to the office WiFi. The list of authorised office networks is managed by your organisation and syncs each time you open the app.

15. Quick Unlock with Fingerprint or Face ID

After your first login, the app can greet you with "Welcome back" and ask for your fingerprint or Face ID instead of your password. Tap Authenticate, or choose Use password instead. If you forget your password, use Forgot Password on the login screen.

16. Field Tracking

If your organisation has enabled field tracking for you, the app records your location every few minutes while you are punched in — never before punch-in or after punch-out. My Field Tracking shows your distance per day and lets you Export Excel for travel reimbursement. See Field Tracking.