Virtual Ride transforms your indoor cardio workouts into immersive outdoor adventures. Built with Jetpack Compose, this app uses intelligent head-motion tracking to sync real-world effort with stunning point-of-view videos from around the globe. Whether you're on a bike, treadmill, elliptical, or rowing machine, your workout controls the pace.
-
✅ Motion-Controlled Video: Uses the front-camera and ML Kit Face Detection to adjust video playback speed in real-time based on your head movements.
-
✅ Bring Your Own Scenery: Add your own workout videos directly from your device storage or by pasting a direct MP4 URL. The app automatically generates thumbnails.
-
✅ Multi-Equipment Support: Dedicated modes for Bike, Treadmill, Elliptical, and Rowing workouts.
-
✅ BLE Fitness Tracker Integration: Connects to devices like Mi Band and Samsung Fit to track heart rate, steps, distance, and calories via a custom GATT implementation.
-
✅ Performance Analysis: In-depth charts and trends for weight, heart rate zones, speed, and calories burned, visualized with the Vico charting library.
-
✅ Workout History & Sharing: Automatically saves workout sessions with detailed stats, perceived exertion ratings, and notes. Supports sharing summary cards.
-
✅ Customizable Controls: Fine-tune sensitivity, dead zone, and smoothing for a personalized motion-tracking experience.
-
✅ Material 3 UI: Modern, clean interface built with latest Material Design components, supporting portrait and landscape layouts.
| Device Type | Connection | Heart Rate | Steps/Distance | Calories | Battery | Notes |
|---|---|---|---|---|---|---|
| Mi Band | BLE | ✅ | ✅ | ✅ | ✅ | Supports continuous HR streaming |
| Samsung Fit | BLE | ✅ | ✅ | ✅ | ✅ | May require official Galaxy Wearable app |
| Generic HR Monitors | BLE | ✅ | ✖️ | ✖️ | ✅ | Connects via standard Heart Rate Service UUID |
├── ui/
│ ├── main/ # Main screen with video carousel & navigation
│ ├── settings/ # Composable screens for all app settings
│ ├── analysis/ # Performance charts and historical data views
│ ├── history/ # Workout history list and detail views
│ └── video/ # In-workout screen with player & metric overlays
│
├── data/
│ ├── local/ # Room DB: WorkoutSession, HealthMetric, DAOs
│ ├── remote/ # Fake API service for bundled video data
│ ├── bluetooth/ # FitnessManager for BLE device communication
│ ├── model/ # Data models (VideoData, FitnessData, etc.)
│ └── repository/ # Repositories for workout and video data
│
├── viewmodel/
│ ├── MainViewModel.kt # Central ViewModel managing app state
│ └── ViewModelFactory.kt # Factory for creating ViewModels
│
└── di/
└── AppContainer.kt # Dependency injection container
✅ MVVM Architecture: Clean separation of UI, business logic, and data
✅ Jetpack Compose: Fully declarative UI for modern Android apps
✅ Room Database: Robust local storage for workouts and health data
✅ Kotlin Coroutines & Flow: Asynchronous management for BLE, DB, and UI updates
✅ Custom BLE GATT Implementation: FitnessManager.kt handles fitness tracker communication
- Android Studio Iguana+
- Minimum SDK: 28 (Android 10.0+)
- Physical Android device with front-facing camera recommended for motion features
- UI: Jetpack Compose, Material 3, Navigation Component
- Video Playback: ExoPlayer
- Database: Room
- Async: Kotlin Coroutines & Flow
- Image Loading: Coil
- Charting: Vico (Patryk and Patrick)
- Motion Tracking: CameraX, Google ML Kit Face Detection
- Clone the repository:
git clone https://github.com/dimadusk/VirtualRide.git cd VirtualRide - Open the project in Android Studio
- Build and run on an Android device or emulator
- Grant Camera, Storage, and Bluetooth permissions when prompted
The app uses SettingsManager to persist user preferences:
- Ride Controls: Sensitivity, dead zone, smoothing factor for motion tracking
- User Biometrics: Height, birth year, gender, max heart rate for accurate calculations
- Unit System: Metric (km/h, kg) or Imperial (mph, lbs)
- Device Management: Remembers last connected Bluetooth fitness tracker
Virtual Ride supports multilingual UI in:
English, Ukrainian (uk), Czech (cs), Danish (da), German (de), Greek (el), Spanish (es),
Estonian (et), Finnish (fi), French (fr), Croatian (hr), Hungarian (hu), Indonesian (in), Italian (it),
Japanese (ja), Korean (ko), Lithuanian (lt), Latvian (lv), Dutch (nl), Norwegian (no), Polish (pl),
Portuguese (pt), Romanian (ro), Slovak (sk), Serbian (sr), Swedish (sv), Turkish (tr),
Traditional Chinese (zh-rTW), Arabic (ar), Hindi (hi), Hebrew (he)
- Core motion-controlled video playback with CameraX and ML Kit
- BLE integration with Mi Band, Samsung Fit, and generic HR monitors
- Local video import via device storage or direct URLs
- Workout history tracking and analysis with charts
- Add cadence sensor support for cycling workouts
- Custom workout plans and interval timers
- Enhanced social sharing features beyond images
- Gamification: achievements, challenges, milestones
- Expanded video library with online content integration
- Fork the repo
- Create a feature branch (
git checkout -b feature/my-feature) - Commit changes (
git commit -am 'Add feature') - Push branch (
git push origin feature/my-feature) - Open a Pull Request
MIT License
© 2025 dimadusk
Permission is hereby granted, free of charge, to any person obtaining a copy...
See full LICENSE for more details.
Built with ❤️ by @dimadusk
If this helped you, consider ⭐ starring the repo!
| Main Screen | Workout History | Performance Analysis |
|---|---|---|
 |
 |
 |
| In-Workout | Settings | All Tours |
|---|---|---|
 |
 |
 |
🎞️ Phone Demo (.gif)
| Main Screen (Landscape) | Menu (Landscape) |
|---|---|
 |
 |
🎞️ Tablet Demo (.gif)
If you find Virtual Ride helpful, consider supporting its development ❤️
