Timesaver (0.0.2-alpha)

Optimize your productivity with automatic time tracking and effortless task switching.
Stay focused on work, get insights on your day, and achieve more.

Table of Contents

See Table of Contents

1. Features
2. Screenshots
3. Built With
4. Roadmap
5. Gettiing Started
   • Prerequisites
   • Build App via Android Studio
   • Build App via CLI

Features

• ⏱️ Track your productivity: Time your work and breaks with fast switching
• 📊 Visualize your progress: Watch progress bars grow across time
• 📔 Logging in real-time: Know exactly when and how long you did anything
• 📈 Graphs: Review a your time at a glance (currently in development)
• 🎨 Color-code & Theming: Color-code activities & change app theme (currently in development)
• 📵 Offline: No internet needed to use

Screenshots

Built with

• Kotlin and Jetpack Compose for best modern Android practices
• Reactive coroutines and flows for efficient app performance
• The MVVM (Model, View, ViewModel) architecture
• A single-activity architecture with navigation fragments
• A local Room (SQLite) database for data persistence
• Paging for in-memory caching and saving system resources
• Instrumented unit testing

Roadmap

• Graphs for activity insights fragment
• Customize activity colors
• Color code the action bars in activity fragment and the list items in activity menu fragment
• Add app theme options - use prettier colors than the default Android theme
• Add search for logs fragment - when was I doing this, or what was I doing at this time?
• Note-taking for each day, include
• Include a graphs fragment with a retrospective section that has feedback?
• Integrate migration to Timewarrior

Getting Started

Prerequisites

• Android Studio (see docs for installation)
• Kotlin and XML
• Gradle
• A physical Android phone or an Android Virtual Device (AVD)

Build App via Android Studio (see docs)

1) Import Project

• In Android Studio, go to: File --> New --> New Project from Version Control
• Enter the GitHub repo URL:

[email protected]:AngelynDisguise/Timesaver.git

Then the repo will be created as a new project in Android Studio.

2) Run

• In the target device menu, select the device to run the app on
• Click "Run" to build and run app

Build App via CLI (see docs)

1) Import Project

git clone [email protected]:AngelynDisguise/Timesaver.git

2) Build a debug APK

• Use the Gradle wrapper to build:

cd ~/AndroidStudioProjects/Timesaver

./gradlew build

or

• Build via Android Studio: Build --> Build App Bundle(s) / APK(s) --> Build APK(s)

3) Connect to an Android emulator or a physical Android device

4) Install the app using adb

cd ./app/build/outputs/apk/debug

adb install app-debug.apk