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
- ⏰ 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
- 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
- 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
- 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
- Go to Releases
- Download
TimeMachineV3.0.0.apk - Enable "Install from Unknown Sources" in your Android settings
- Open the APK and install
- Android 12 (API 31) or higher
- ARM or x86 processor
- ~100MB free storage (58MB APK + data)
- Open the app - Launch TimeMachine
- Set duration - Scroll the time wheels to select hours and minutes
- Default is 25 minutes (perfect for focus sessions)
- Tap Start - Big blue button starts the countdown
- Background mode - Notification appears with countdown
- Close app (optional) - Timer continues running in background
- Get notified - Alarm sound + vibration when complete (even if app is closed)
- Dismiss - Tap to stop the alarm
- 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
The classic Focus Timer technique:
- Work: Set timer for 25 minutes and focus
- Short break: Set timer for 5 minutes and rest
- Repeat: After 4 pomodoros, take a longer 15-30 minute break
- 🏋️ 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
- Android Studio Hedgehog (2023.1.1) or later
- JDK 11 or higher
- Android SDK with API 36
- Git
# 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 installDebugTimeManager/
├── 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
- Language: Kotlin 2.0.21
- UI Framework: Jetpack Compose
- Material: Material 3
- Build System: Gradle 8.13.0
- Compose Runtime - State management
- Kotlin Coroutines - Asynchronous operations
- LazyColumn - Scrollable time picker
- AnimatedContent - Smooth transitions
- MediaPlayer - Alarm sound playback
- Vibrator - Haptic feedback
- System Theme - Auto dark/light mode
- ProGuard/R8 - Code minification
- Resource Shrinking - Unused resource removal
- Vector Drawables - Scalable icons
-
Update Version in
app/build.gradle.kts:versionCode = 2 versionName = "1.0.1"
-
Build Release APK:
./gradlew assembleRelease cp app/build/outputs/apk/release/app-release.apk Focus TimerTimer-v1.0.1.apk
-
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
-
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"
## 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.1Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is open source and available under the MIT License.
None at the moment! 🎉
If you find any bugs, please open an issue.
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
- Developer: Ali Ahad
- Email: ali@aliahad.me
- Website: aliahad.me
- 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!