⏱️ TimeMachine

A comprehensive productivity & health tracking app for Android built with Jetpack Compose

Focus Tracker • Screen Time • Habit Tracker • Year Calculator • BMI Calculator • Expense Tracker • Subscription Tracker • Daily Planner

Download APK • Report Bug • Request Feature

---

📱 Screenshots

Home & Navigation

Focus Tracker & Screen Time

Habit Tracker

Expense & Subscription Tracker

Daily Planner & Calculators

Settings & Data Management

✨ Features

🎯 Core Functionality

• ⏰ Custom Duration - Set any duration from 1 minute to 23 hours 59 minutes
• ⏱️ Real-Time Countdown - Watch the timer count down with visual progress indicator
• 📱 Background Service - Timer continues running even when app is closed
• 🔔 Persistent Notification - Always-visible countdown in status bar and notification shade
• 🔔 Alarm Sound - System alarm plays when timer completes
• 📳 Vibration - Physical feedback with repeating vibration pattern
• 🛑 Stop Anytime - Cancel the timer from app or notification

🎨 User Experience

• Apple-Style Picker - Smooth, scrollable wheels for time selection (just like iOS)
• Circular Progress - Beautiful circular indicator shows remaining time
• Minimal Design - Clean, distraction-free interface
• Smooth Animations - Polished transitions between states
• Large Touch Targets - Easy to use with one hand

🌓 Appearance

• Auto Dark/Light Mode - Follows your system preferences
• Material 3 Design - Modern Android design language
• Clean Colors - Blue accent with high contrast
• Edge-to-Edge - Immersive full-screen experience

🔧 Technical

• Comprehensive - 58MB APK with 8+ productivity modules
• No Ads - Completely ad-free experience
• No Internet Required - Works 100% offline
• Room Database v13 - Robust local data persistence
• Lifecycle Aware - Smart UI updates and state management
• Real-time Sync - Automatic data refresh across all screens
• WorkManager - Battery-efficient background tasks
• UsageStats API - System-level accurate screen time tracking
• ProGuard Optimized - Minified and shrunk for performance

---

📥 Installation

Download APK

1. Go to Releases
2. Download TimeMachineV3.0.0.apk
3. Enable "Install from Unknown Sources" in your Android settings
4. Open the APK and install

Minimum Requirements

• Android 12 (API 31) or higher
• ARM or x86 processor
• ~100MB free storage (58MB APK + data)

---

🚀 Usage

Setting a Timer

1. Open the app - Launch TimeMachine
2. Set duration - Scroll the time wheels to select hours and minutes
   • Default is 25 minutes (perfect for focus sessions)
3. Tap Start - Big blue button starts the countdown
4. Background mode - Notification appears with countdown
5. Close app (optional) - Timer continues running in background
6. Get notified - Alarm sound + vibration when complete (even if app is closed)
7. Dismiss - Tap to stop the alarm

Background Operation

• Persistent notification - Shows remaining time in status bar
• Stop from notification - Use "Stop" button without opening app
• Tap to return - Tap notification to see full timer
• Survives closure - Timer runs even if you force-close the app
• Lock screen safe - Continues running when screen is locked

Focus Timer Technique

The classic Focus Timer technique:

1. Work: Set timer for 25 minutes and focus
2. Short break: Set timer for 5 minutes and rest
3. Repeat: After 4 pomodoros, take a longer 15-30 minute break

Other Use Cases

• 🏋️ Workout intervals - HIIT, rest periods, exercise durations
• 🧘 Meditation - Timed meditation sessions
• 👨‍🍳 Cooking - Track cooking times
• ☕ Coffee brewing - Perfect pour-over timing
• 📚 Study sessions - Focused learning blocks
• 🎮 Screen time limits - Gaming or social media breaks
• 🧺 Chores - Time-boxed cleaning sessions

---

🛠️ Build from Source

Prerequisites

• Android Studio Hedgehog (2023.1.1) or later
• JDK 11 or higher
• Android SDK with API 36
• Git

Clone & Build

# Clone the repository
git clone https://github.com/aliahadmd/TimeMachine.git
cd TimeManager

# Build debug APK
./gradlew assembleDebug

# Build release APK (requires keystore)
./gradlew assembleRelease

# Install on connected device
./gradlew installDebug

Project Structure

TimeManager/
├── app/
│   ├── src/main/
│   │   ├── java/me/aliahad/timemanager/
│   │   │   ├── MainActivity.kt          # App entry point
│   │   │   ├── TimerScreen.kt           # Main timer UI
│   │   │   └── ui/theme/                # Theme & colors
│   │   ├── res/                         # Resources
│   │   └── AndroidManifest.xml
│   ├── build.gradle.kts                 # App config
│   └── proguard-rules.pro               # ProGuard rules
├── gradle/
├── build.gradle.kts                     # Project config
└── README.md

---

🏗️ Tech Stack

Core

• Language: Kotlin 2.0.21
• UI Framework: Jetpack Compose
• Material: Material 3
• Build System: Gradle 8.13.0

Architecture

• Compose Runtime - State management
• Kotlin Coroutines - Asynchronous operations
• LazyColumn - Scrollable time picker
• AnimatedContent - Smooth transitions

Android Components

• MediaPlayer - Alarm sound playback
• Vibrator - Haptic feedback
• System Theme - Auto dark/light mode

Optimization

• ProGuard/R8 - Code minification
• Resource Shrinking - Unused resource removal
• Vector Drawables - Scalable icons

---

📦 Publishing Releases on GitHub

Automated Release Process

1. Update Version in app/build.gradle.kts:

   versionCode = 2
   versionName = "1.0.1"

2. Build Release APK:

   ./gradlew assembleRelease
   cp app/build/outputs/apk/release/app-release.apk Focus TimerTimer-v1.0.1.apk

3. Commit Changes:

   git add .
   git commit -m "Release v1.0.1"
   git tag -a v1.0.1 -m "Version 1.0.1"
   git push origin main --tags

4. Create GitHub Release:

   • Go to your repo on GitHub
   • Click "Releases" → "Draft a new release"
   • Choose tag: v1.0.1
   • Release title: v1.0.1 - [Brief description]
   • Add release notes (see template below)
   • Attach Focus TimerTimer-v1.0.1.apk
   • Click "Publish release"

Release Notes Template

## What's New in v1.0.1

### 🎉 New Features
- Feature description here

### 🐛 Bug Fixes
- Bug fix description here

### 🔧 Improvements
- Improvement description here

### 📥 Installation
Download `Focus TimerTimer-v1.0.1.apk` below and install on your Android device.

**Minimum Android Version**: Android 12 (API 31)

**Full Changelog**: https://github.com/aliahadmd/TimeMachine/compare/v1.0.0...v1.0.1

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

This project is open source and available under the MIT License.

---

🐛 Known Issues

None at the moment! 🎉

If you find any bugs, please open an issue.

---

💡 Future Enhancements

Ideas for future versions:

• Save favorite timer presets
• Multiple timer profiles
• Statistics and usage tracking
• Custom alarm sounds
• Widget support
• Background timer notifications
• Pause/resume functionality
• Custom color themes

---

📞 Contact & Support

• Developer: Ali Ahad
• Email: [email protected]
• Website: aliahad.me

---

🙏 Acknowledgments

• Jetpack Compose team for the amazing framework
• Material Design for the design guidelines
• Focus Timer Technique by Francesco Cirillo

---

Built with ❤️ using Jetpack Compose

⭐ Star this repo if you find it helpful!