truecaller-lite

KO | EN

gitlite — search

#php #python #javascript #ruby #hacktoberfest #vim #video #dotfiles #macos #plugin #osdev #cross-platform

truecaller-lite

★ 38 Open GitHub ↗

Lightweight, ad-free Android app that shows caller names in a popup using Truecaller API—no need for the full Truecaller app. Just tap Start, and get caller info on incoming calls from unknown numbers.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 📞 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 |
|---------------------|-----------------|
| <img src="https://github.com/user-attachments/assets/f595c5b7-d175-4009-8ae3-690a9576c1a3" alt="Incoming Call Popup" width="300"/> | <img src="https://github.com/user-attachments/assets/96aa63f9-1c69-4046-b9c5-ddf81569a67c" alt="Service RunningI" width="300"/> |

## 📦 Tech Stack

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

## 📦 Installation

1. Clone this repository:
   ```bash
   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](https://github.com/r0ld3x/truecaller-lite/blob/bac0b9e636ffbc16719ff0d1f6da8ad89b5d196a/app/src/main/java/com/r0ld3x/truecaller/ApiInstance.kt#L17) (incase you wanna change) `already added by default`
4. List your api inside the [network_security_config.xml](https://github.com/r0ld3x/truecaller-lite/blob/bac0b9e636ffbc16719ff0d1f6da8ad89b5d196a/app/src/main/res/xml/network_security_config.xml#L5)  (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:

```bash
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`):

```bash
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

truecaller-lite

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README