jeena/pacer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
23 commits 1 branch 0 tags 368 KiB
Find a file
Jeena d79fcebc41 ui: Add landscape two-column layout (US-18) 
Detect orientation via LocalConfiguration and switch to a Row-based
two-column layout in landscape mode. Left column shows the title, BPM
display and pulse ring; right column shows the BPM slider, presets,
volume slider and the START/STOP button. All controls remain visible
without scrolling. Portrait layout is unchanged.

Extracted shared UI into private composables (Title, BpmDisplay,
PulseRing, BpmControls, VolumeControl, StartStopButton) to avoid
duplication between the two layout paths.
2026-03-10 02:18:48 +00:00
app ui: Add landscape two-column layout (US-18) 2026-03-10 02:18:48 +00:00
gradle test(US-11): add failing tests for settings persistence 2026-03-09 12:04:14 +00:00
.gitignore feat(US-16): configure release signing and minification 2026-03-09 12:24:44 +00:00
AGENTS.md Set up Android project with Kotlin and Jetpack Compose 2026-03-09 06:51:42 +00:00
BACKLOG.md ui: Add landscape two-column layout (US-18) 2026-03-10 02:18:48 +00:00
build.gradle.kts Set up Android project with Kotlin and Jetpack Compose 2026-03-09 06:51:42 +00:00
gradle.properties Set up Android project with Kotlin and Jetpack Compose 2026-03-09 06:51:42 +00:00
gradlew Set up Android project with Kotlin and Jetpack Compose 2026-03-09 06:51:42 +00:00
gradlew.bat Set up Android project with Kotlin and Jetpack Compose 2026-03-09 06:51:42 +00:00
README.md Set up Android project with Kotlin and Jetpack Compose 2026-03-09 06:51:42 +00:00
settings.gradle.kts Set up Android project with Kotlin and Jetpack Compose 2026-03-09 06:51:42 +00:00

README.md

Pacer

A native Android pacing/metronome app that plays 880 Hz beeps at a user-set BPM to maintain walking pace. Runs in the background for 2+ hour walks without draining battery. Plays alongside other audio apps (podcasts, music) without requesting audio focus.

Ported from the web version at https://jeena.net/pacer/

Building on Arch Linux

1. Install Java 17

sudo pacman -S jdk17-openjdk

Set JAVA_HOME (add to ~/.bashrc or ~/.zshrc):

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH="$JAVA_HOME/bin:$PATH"

Verify: java -version should show openjdk version "17.x.x".

2. Install Android SDK via AUR

# Remove old package if previously installed (it leaves files behind — clean them up too)
sudo pacman -Rns android-sdk
sudo rm -rf /opt/android-sdk/platform-tools /opt/android-sdk/tools

# Install modern SDK tools
paru -S android-sdk-cmdline-tools-latest android-sdk-platform-tools android-sdk-build-tools android-platform

The packages install to /opt/android-sdk. Add to ~/.bashrc or ~/.zshrc:

export ANDROID_HOME=/opt/android-sdk
export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$PATH"

Reload: source ~/.bashrc

3. Accept SDK Licenses

sudo /opt/android-sdk/cmdline-tools/latest/bin/sdkmanager --licenses

4. Bootstrap the Gradle Wrapper

The first time only, install system Gradle to generate the wrapper binary:

sudo pacman -S gradle
cd /path/to/Pacer
gradle wrapper --gradle-version 8.7 --distribution-type bin
sudo pacman -Rs gradle  # optional: remove system gradle afterwards

5. Build

./gradlew assembleDebug

The debug APK will be at: app/build/outputs/apk/debug/app-debug.apk

6. Install on a Device

Enable USB debugging (Settings > Developer Options > USB Debugging), connect via USB, then:

./gradlew installDebug
# or
adb install app/build/outputs/apk/debug/app-debug.apk

Troubleshooting

ANDROID_HOME not set — Reload your shell profile or open a new terminal.

License for package ... not accepted — Run sudo /opt/android-sdk/cmdline-tools/latest/bin/sdkmanager --licenses.

Unsupported class file major version — Wrong Java version. Confirm java -version shows 17 and JAVA_HOME points to /usr/lib/jvm/java-17-openjdk.

Permission denied on /opt/android-sdk — Run sdkmanager with sudo.

Failed to install build-tools;34.0.0 ... SDK directory is not writable — AGP tried to auto-download build-tools instead of using the installed version. Ensure buildToolsVersion = "36.1.0" is set in app/build.gradle.kts.

Development

See AGENTS.md for the developer/agent workflow guide. See BACKLOG.md for all user stories and acceptance criteria.

./gradlew test    # unit tests
./gradlew lint    # lint checks