📞 Minimal Truecaller Popup - Lightweight Caller ID App

A simple and ad-free Android app that displays caller names using the Truecaller API—no need to install the official Truecaller app!

🚀 Features

• ✅ Lightweight & fast
• ✅ No ads or background clutter
• ✅ Uses Truecaller API to fetch caller names
• ✅ Popup UI with caller name on incoming unknown calls
• ✅ Start/Stop background service with one tap
• ✅ Manual number search: enter a phone number to get the caller's name and location

🛠️ How It Works

1. Launch the app.
2. Tap the Start button to activate the background service.
3. When you receive a call from an unknown number, a popup will display the caller’s name.
4. Tap Stop anytime to disable the service.

📷 Screenshots

Incoming Call Popup	Service Running

📦 Tech Stack

• Android (Kotlin)
• Foreground Service
• Truecaller API Integration ( Third Party )
• Phone Manager Android Api
• Material Design Components

📦 Installation

1. Clone this repository:

   git clone https://github.com/r0ld3x/truecaller-lite.git

2. Open the project in Android Studio.
3. List your api key inside the com/r0ld3x/truecaller/ApiInstance.kt (incase you wanna change) already added by default
4. List your api inside the network_security_config.xml (incase you wanna change)
5. Run on an emulator or physical Android device.

☕ Gradle JDK Requirement (Local + CI)

This project requires JDK 17 for Gradle runtime.

On Linux (Ubuntu/Debian), you can set it up with:

sudo apt-get update
sudo apt-get install -y openjdk-17-jdk
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH="$JAVA_HOME/bin:$PATH"
./gradlew --version
./gradlew assembleDebug

To persist JAVA_HOME, add these to your shell profile (for example ~/.bashrc):

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

🔐 Release signing in GitHub Actions

The release workflow builds with signing only when these repository secrets are set:

• KEYSTORE_BASE64 (base64 content of the .jks file)
• KEYSTORE_PASSWORD
• KEY_ALIAS
• KEY_PASSWORD

If secrets are missing, assembleRelease still runs and produces an unsigned release APK.

⚠️ Disclaimer

This app is not affiliated with or endorsed by Truecaller. It uses public endpoints purely for demonstration or educational purposes.

📝 License

This project is licensed under the MIT License.

Made with ❤️ by Roldex