Jugaad

An Android app that forwards SMS messages to Slack.

This app relies on the restricted READ_SMS permission and needs several workarounds on most devices. For internal use.

Installation

1. Download the latest app-release.apk from the Releases page and install the app. (A new release is automatically created for every commit to the main branch). You might need to disable play protect.
2. Allow restricted settings for Jugaad.
3. Allow developer options.
4. Grant SMS permissions when prompted. Configure the device name, webhook URLs etc.

Developing

Building Locally

Build and install to emulator:

./gradlew assembleDebug && adb install app/build/outputs/apk/debug/app-debug.apk

You can also use Android Studio to build and run the app.

Signing Apps Locally

To build signed release APKs locally:

1. Run ./setup-signing.sh to generate the signing keystore
2. Build the signed APK:

   KEYSTORE_PASSWORD=jugaad-password KEY_ALIAS=jugaad-key-alias KEY_PASSWORD=jugaad-password ./gradlew assembleRelease

The keystore (jugaad-release-key.jks) will remain in your project directory for local builds.

Testing SMS on Device Emulator

You can trigger SMSes to an emulator device via telnet for testing:

telnet localhost 5554
auth <token_from_~/.emulator_console_auth_token>
sms send 9987987986 "Your OTP is 123456"

Setting up GitHub Actions for Signed Builds (One-time)

1. Run ./setup-signing.sh to generate signing keys and get GitHub secrets
2. Add the 4 secrets to your GitHub repo: Settings → Secrets and variables → Actions
3. Push your code - GitHub Actions will automatically build signed APKs and create public releases

License

This project is licensed under the MIT License - see the LICENSE file for details.