search

StephGit / EazyTime

Android app for time tracking
MIT License
2 stars 2 forks source link
android androidx broadcast-reciever coroutines dagger2-android geofence kotlin livecycle localization lockscreen maps-api places-api room widget

readme

EazyTime App eazytime-logo

Build Status

Simple time tracking app for Android in Kotlin.

Table of Contents

What is it?
Technologies
Getting Started

What is it?

Android-App to detect when I arrived or left the office with help of geofences. In addition, I can manage my working hours manually and assign different projects. The app allows me to view my working hours of the past few days.

Project View

Add your projects to book working time on them.

ProjectView

For each project you can define a name, shortcode and set if it should be displayed on the widget. Up to five projects can be displayed on the widget and as well on a LockScreenNotification. With the LockScreenNotification you can start/stop bookings even without unlocking your device. You have the possibility to set one default project, which will be triggered on entering a geofence.

ProjectView

Calendar View

Simple overview of your bookings. Shows days with a total of booked time:

CalenderView

And a detail view per day with the booked time slots per project.

CalenderDetail

Geofence View

Allows you to add geofences for your working areas. As soon you enter a active geofence, your default project is triggered. If there's already a running project nothing happens. Leaving a geofence ends the booking on the current running project.

GeofenceEdit

Technologies

Project is migrated to AndroidX. Find more information about AndroidX here.

Getting Started

The app is not released yet, so you have to build a debug apk. Download the app by cloning this repository and use the gradlew installDebug command to build and install the project directly on your connected device or running emulator.

GoogleMap and Places API

The app uses Google Maps and Places API for the geofence-feature. If you want to use this feature, you need to get your own API-Key from Google Cloud Platforms. Make sure to register your API key for Maps SDK for Android and Places API.

Add the key to the resource-file google_api.xml by replacing YOUR_API_KEY with the value of your API key.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="google_api_key" translatable="false" templateMergeStrategy="preserve">
        YOUR_API_KEY
    </string>
</resources>

Connect your device

Follow these steps to connect your device:

  1. Connect your device by USB
  2. Enable 'Developer options > USB debugging' on your device (Developer options is hidden by default. To make it available, go to 'Settings > About phone' and tap 'Build number' seven times)
  3. Now you should see your device with adb device -l (if not use adb usb to activate usb-connection)

    optional connection by wifi

  4. Activate Wifi-Connection
  5. adb tcpip 5555
  6. adb connect <XXX.XXX.X.XXX>:5555 > add the ip-adress of your device ('Settings > About phone > Status')
  7. Enjoy