PomoWatch ⌚

A minimal, zero-sensor, infinite-loop Pomodoro timer built specifically for Wear OS 6+ (Samsung Galaxy Watch 4 and newer).

---

Why PomoWatch?

Standard smart watch inactivity and interval alerts rely on accelerometer / heart-rate sensors that often fail, lag, or miss alerts. PomoWatch operates purely on deterministic time loops without any sensor dependencies.

• Only 2 taps a day: Tap START when you start work; tap STOP when you finish your day. Everything else runs continuously in an automated loop.
• Zero-CPU Deep Sleep Timing: The background service uses AlarmManager.setExactAndAllowWhileIdle(), allowing the watch CPU to enter full low-power Doze sleep during countdowns. Zero unnecessary battery drain.
• 3-Second Transition Alerts:
  • Work $\rightarrow$ Break (3s Alert with 3 strong pulse waveforms)
  • Break $\rightarrow$ Work (3s Alert with 2 energetic pulse waveforms)
  • Wakes the screen and plays notification audio chime (if sound is unmuted).
• Featherweight Native Android SDK: Pure Kotlin with zero heavy UI libraries or bloated runtimes (<100KB footprint).
• AMOLED Pure-Black UI: #000000 background for minimal battery consumption when viewing the screen.

---

🧪 Testing on Your Computer

We provide two convenient ways to test before installing on your watch:

Option 1: Instant Interactive Watch Simulator (Recommended)

Launch the standalone interactive Samsung Galaxy Watch 4 simulator with audio chimes, wrist haptic feedback animations, and fast-forward testing (10x / 60x speed):

./scripts/start_simulator.sh

Or simply open simulator/index.html in your browser.

Option 2: Full Android Wear OS Emulator

To boot an official QEMU/KVM virtual Wear OS watch and install the compiled APK:

./scripts/setup_android_emulator.sh

---

📱 Build & Install on Physical Samsung Galaxy Watch 4

1. Build APK

./gradlew assembleRelease
# APK generated at: app/build/outputs/apk/release/app-release.apk (88 KB)

2. Install on Galaxy Watch 4 via ADB Wi-Fi

1. On your Galaxy Watch 4:
   • Go to Settings $\rightarrow$ Developer Options.
   • Enable ADB Debugging and Wireless Debugging.
   • Note the IP address and Port (e.g. 192.168.1.50:5555).
2. On your computer:

adb connect <WATCH_IP>:<PORT>
adb install -r app/build/outputs/apk/release/app-release.apk