KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

droidrunco

★ 35 Open GitHub ↗

Minimalist, functional Android debloat tool in Go

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Archival notice

Droidrunco is being superseded by [zilch](https://github.com/lavafroth/zilch) which features a native
desktop app, ADB functionality built into a single binary and stronger guarantees of reverting an uninstalled app.

Droidrunco will not receive any further updates.

Thank you for trying out my software :)

---

# Droidrunco
Your Android device. Cleaner.

![demo screenshot](https://raw.githubusercontent.com/lavafroth/droidrunco/main/screenshots/demo.png)

- [Introduction](https://github.com/lavafroth/droidrunco#Introduction)
- [Installation](https://github.com/lavafroth/droidrunco#Installation)
- [Usage](https://github.com/lavafroth/droidrunco#Usage)
- [Demo](https://odysee.com/@lavafroth:d/droidrunco_wireless_debugging:d)
- [Acknowledgement](https://github.com/lavafroth/droidrunco#Acknowledgement)

[![Go Report Card](https://goreportcard.com/badge/github.com/lavafroth/droidrunco)](https://goreportcard.com/report/github.com/lavafroth/debloatplusplus)

## Introduction

### What?

Droidrunco is a cross-platform web UI based application which utilizes `adb` to help
remove unwanted system apps ([bloatware](https://en.wikipedia.org/wiki/Software_bloat)) from
on all versions of Android with x86 or ARM processors without root access. This subsequently
increases storage space, reduces power consumption and hardens the user's privacy against
vendor distributed spyware.

### Why?

- Other debloat tools do not extract app labels.
- It becomes difficult to correlate package names with labels.
- Guessing which package to delete risks [bootloop](https://en.wikipedia.org/wiki/Bootloop).

### Solution

Droidrunco will

- Fetch the app labels using the android `PackageManager` API.
- Divide which apps are safe to remove into 5 levels of risk.

Stick to the recommended removal list if you don't know what you are doing.

## Installation

There are some prebuilt packages

- [AUR package by @robertfoster](https://aur.archlinux.org/packages/droidrunco): `yay droidrunco`
- Nix, NixOS and macOS package maintained by me: `nix run github:lavafroth/droidrunco`

If you prefer other package managers follow these steps:

### Install ADB

- Debian: `sudo apt install android-sdk-platform-tools`
- Arch: `sudo pacman -S android-tools`
- Red Hat: `sudo yum install android-tools`
- OpenSUSE: `sudo zypper install android-tools`
- Termux: `pkg in android-tools`
- Windows: `winget install Google.PlatformTools`

### Install Droidrunco

Droidrunco can be installed in either of the following ways:

#### Using precompiled binaries
Download a binary for your operating system from the [releases](https://github.com/lavafroth/droidrunco/releases).

#### From source

```bash
git clone https://github.com/lavafroth/droidrunco.git
cd droidrunco
go build
```

## Usage
- Backup the data on your device before you accidentally screw up
- [Enable Developer Options and USB debugging on your device](https://developer.android.com/studio/debug/dev-options#enable)
- From the settings, disconnect from any OEM / vendor accounts (deleting an OEM account package could lock you on the lockscreen because the device can no longer associate your identity)
- Kill any previously running adb servers on the host
```
adb kill-server
```
- Run Droidrunco (this might need administrative rights depending on the operation system in use)
- Visit http://localhost:8080
- Start typing to search for an app
- Click the trash icon next to the app's entry to wipe it. The icon color indicated the severity of uninstalling the app.
  - Green: Recommended
  - Lime: Advanced
  - Yellow: Expert
  - Red: Unsafe
  - Gray: Untested
- If an essential system app gets accidentally removed and Droidrunco is still running, click the recycle icon next to the entry to restore it

## Debloating without a PC

The best part about Droidrunco is that you can run the [ARM version](https://github.com/lavafroth/droidrunco/releases/latest) in [Termux](https://termux.dev/en/) and debloat Android 11+ devices.

- In the Android Developer Options, enable wireless debugging
- Under wireless debugging, click on pair a device, note the IP:PORT pair and the KEY.

- Open termux and run the following:

```sh
pkg in wget android-tools
adb pair IP:PORT KEY
```

Where IP, PORT and KEY are the identifiers noted from the wireless debugging menu.

- Back in the wireless debugging settings page, note the IP and PORT for _connecting_ to the device.
Note that the PORT is usually different in this case.

- Run the following in Termux:

```sh
adb connect IP:PORT
```

- The target device should get a notification stating that a debugger has been connected.

- Finally run the following in Termux:

```sh
wget https://github.com/lavafroth/droidrunco/releases/download/v2.3.2/droidrunco-arm-linux
chmod +x droidrunco-arm-linux
./droidrunco-arm-linux
```

> Note: The version used here is 2.3.2 but you may use a higher version if available.

- Go [here](http://localhost:8080).

## Acknowledgement
- [UAD project](https://github.com/0x192/Universal-Android-Debloater) for their application knowledge base that is used in this project.
- Irfan Latif for the dalvik executable to extract app labels.

droidrunco

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README