Redeemly

A gift card and promo code redemption assistant for Android. Uses Accessibility Services to detect configured trigger apps and extract codes directly from the screen.

---

Features

Feature	Description
Share Sheet	Handle code redemption via the standard Android share sheet.
Floating Bubble	Overlay bubble that appears when trigger apps are launched.
Screen Scraper	Extracts codes directly from the screen, bypassing Android clipboard restrictions.
Automator	Batch extraction of codes from lists and emails.
Auto-Redeem Macro	Automatically processes a queue of codes in Google Play.
Google Keep Integration	Export Auto-Redeem results to Google Keep.
Configurable Platforms	Support for custom redemption URLs using a {code} placeholder.
Configurable Triggers	Trigger the floating bubble on specific apps.

Architecture

AccessibilityService
  └── Listens for window state changes to detect trigger apps
  └── On trigger app open → show persistent floating bubble
  └── On bubble tap → Scrape active window for regex-matching codes
  └── On bulk action → Launch Auto-Redeem state machine
  └── Auto-Redeem → Read screen for "Confirm" buttons & success text, perform clicks
  └── On tray close → Bubble remains until explicitly dismissed

ShareActivity
  └── Registered for ACTION_SEND (text/plain)
  └── Shows bottom sheet with platform options
  └── Extracts code from plain text or URL params

MainActivity
  └── Settings: platforms, trigger apps, bubble toggle
  └── Permission banners for overlay + accessibility

---

Build & Install

Android Studio

1. Open this directory in Android Studio.
2. Connect your device with USB debugging enabled.
3. Run the application.

Command Line

Requires: JDK 17+, Android SDK (set ANDROID_HOME)

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

---

Setup

1. Open Redeemly.
2. Grant "Draw over apps" permission when prompted.
3. Enable the Redeemly Accessibility Service.
4. The floating bubble will now appear when opening configured trigger apps.

Adding Triggers

Use the + Add Trigger App button to select an app from your installed applications, or add the package name manually.

Platforms

URL templates for common platforms:

Amazon Pay IN:  https://www.amazon.in/gc/redeem?claimCode={code}
Amazon Pay US:  https://www.amazon.com/gc/redeem?claimCode={code}
Google Play:    https://play.google.com/redeem?code={code}
Paytm:          https://paytm.com/gift-voucher/redeem?code={code}
Flipkart:       https://www.flipkart.com/gift-card/redeem?pin={code}
PhonePe:        https://phon.pe/redeem?code={code}
Myntra:         https://www.myntra.com/giftcard/redeem?code={code}
Uber:           https://m.uber.com/redeem?code={code}

---

Privacy & Permissions

• Screen Content Reading: The Accessibility Service requires canRetrieveWindowContent="true" for screen scraping and Auto-Redeem functionality.
• Auto-Clicking: The service performs automated clicks for the Auto-Redeem macro.
• Local Only: All extraction, scraping, and state tracking is processed on-device. No network requests or analytics. Data is stored locally in SharedPreferences.