Wirecat

KO | EN

gitlite — search

#python #large-language-models #monitoring #automation #cloud-native #kotlin #macos #terminal #postgresql #linux

(★ 9)

Wirecat is an Android app that shows which apps use your data in real time and lets you block their internet access, all locally on your device. you can download the latest version in the releases.

File Explorer

ZIP Download

- .gitignore
- build.gradle.kts
- proguard-rules.pro
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- gradle-daemon-jvm.properties
- libs.versions.toml
.gitignore
build.gradle.kts
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
settings.gradle.kts

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

# Project Badges

banner_1.png

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Local, per-app data usage monitor and network firewall for Android.**

Wirecat shows you exactly which apps are using your data in real time, lets you cut off any app's internet access on demand, and keeps a local log of what's actually happening on the wire, all of it running entirely on-device.

---

## Features

### Data usage monitoring
- Live, per-app data usage while a monitoring session is running (total bytes, current speed, session duration).
- Ranked per-app breakdown across Wi-Fi and mobile data, backed by Android's `NetworkStatsManager`.
- Optional packet capture during monitoring for a closer look at live traffic.

### Tunnel
- Select one or more installed apps and instantly cut off their internet access.
- Implemented with Android's `VpnService`, using `addAllowedApplication()` so *only* the apps you pick are affected.
- No root required.
- **Platform limitation, not a bug:** Android allows exactly one active `VpnService` per device. Tunnel and a separate VPN app cannot both be active at the same time. this is an OS-level restriction with no workaround short of root.

### Packet log
- Every blocked (Tunnel) or captured (Monitoring) packet is logged with protocol (TCP/UDP/ICMP), IP version (IPv4/IPv6), source/destination address and port, size, and the owning app where resolvable.
- Searchable by app, protocol, or address.

### Session history
- Every monitoring session is saved locally (SQLite via a plain `SQLiteOpenHelper`) with its full per-app breakdown, browsable later from the History screen.

### UI
- Single-Activity, fragment-based architecture (`HostActivity` + `HomeFragment` / `LogFragment` / `TunnelFragment` / `SettingsFragment`) with one persistent bottom navigation bar that is never recreated on tab switch.
- Dark and light themes.

### Privacy
- No backend of any kind. Everything Wirecat measures and logs stays in the app's local storage.
- The only network call Wirecat itself makes is to open the donation link you choose to tap.

---

## Tech stack

| | |
|---|---|
| Language | Kotlin |
| Min SDK / Target SDK | 24 / 36 |
| Build | Gradle (no wrapper — see [Building](#building)), Android Gradle Plugin 9.x |
| UI | Android Views + ViewBinding (no Compose) |
| Persistence | Plain `SQLiteOpenHelper` (no Room) |
| Networking primitives | `VpnService`, `NetworkStatsManager`, `ConnectivityManager` |
| Async | Kotlin Coroutines + `Flow` |

## Project structure

```
app/src/main/java/com/soroush/wirecat/
├── ui/               # HostActivity, fragments, adapters, BottomNavController
├── data/             # NetworkStatsHelper, MonitorService, WirecatDbHelper, PacketLogStore
├── vpn/              # TunnelVpnService, MonitorCaptureVpnService
├── util/             # FormatUtils, PermissionUtils, PrefsManager, InsetUtils
└── WirecatApp.kt      # Application class
```

## Permissions

| Permission | Why |
|---|---|
| `PACKAGE_USAGE_STATS` | Required to read per-app data usage (granted manually via system settings — Wirecat prompts for this). |
| `BIND_VPN_SERVICE` / VPN prepare flow | Powers Tunnel and optional packet capture — both are local-only, nothing is proxied off-device. |
| `FOREGROUND_SERVICE*`, `POST_NOTIFICATIONS` | Monitoring and Tunnel run as foreground services with a persistent notification, as Android requires. |
| `QUERY_ALL_PACKAGES` | Needed to list and display every installed app in the usage/Tunnel lists. |

## Building

This project intentionally does **not** ship a Gradle wrapper.

1. Requirements: JDK 17, a local Gradle install compatible with AGP 9.x (developed against Gradle 9.7), Android SDK with `compileSdk 36`.
2. Open in Android Studio and let it sync against your local Gradle distribution (**Settings → Build Tools → Gradle → Gradle distribution → Local installation**), or build from the command line with your own `gradle` on `PATH`.
3. `gradle assembleDebug`

Wirecat

File Explorer

# Use via CDN

# Project Badges

Was this content helpful?

Recent Feedback

Download README