Porter
0.8.2-rc0 · GitHub
More about this app
Minimal, maintained Shizuku fork that gives apps ADB access with optional root, plus a compatibility companion for Shizuku-only apps
Porter
ADB access for your apps.
Porter is a minimal, maintained fork of Shizuku that gives Android apps ADB access through the Shizuku APIs, with optional root support.
Use it with compatible apps to manage other apps and access additional files. You choose which apps get access.
Why Porter exists
I use Shizuku in my own apps, SD Maid SE and Butler. The original Shizuku app was no longer actively maintained, so I started Porter to keep a minimal, stable and maintained alternative available for apps that need ADB access.
Get started
- Install Porter from GitHub Releases.
- Start Porter and follow the in-app instructions (detailed guide).
- Grant access to the apps that ask for it.
To verify the authenticity of a downloaded APK, see SECURITY.md.
Requirements: Android 7.0 or newer, plus either a computer, Android 11 or newer with wireless debugging, or a rooted device.
Porter's service stops when the device restarts. Start it again afterwards.
Using apps that support Shizuku
Apps with built-in Porter support only need Porter.
Apps that only support Shizuku need the Porter Compatibility companion, included in the Porter download. Start Porter, open Shizuku compatibility from the home screen and follow the instructions.
If Shizuku is installed, leave it installed: that screen offers to replace it and carry over your existing access choices.
Choose the right setup for your apps.
For users
Read the Porter user guide, available in ten languages with automatic language selection.
For developers
Other app developers are welcome to support Porter's permission directly. Add direct Porter support to your app.
Screenshots






About
Porter builds on RikkaApps/Shizuku and the maintenance work by thedjchi and contributors. It is not affiliated with the original Shizuku maintainers.
License
Porter's code is available under Apache 2.0; the bundled Shizuku API uses the MIT license. This excludes:
- Porter icons, logos, mascots, marketing materials and assets.
- Porter documentation.
- Google Play screenshots.
- Google Play texts & descriptions.
Apps that support Porter may use the unmodified Porter icon to refer to it. See NOTICE for attribution and terms.
How Shizuku is used
Can manage companion app via `pm install` and `pm uninstall`, stop original service via `ps`, `cat` and `kill`, capture logs via `logcat` and update service via starter binary
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Porter uses its privileged service to manage Shizuku compatibility for other apps and to maintain and diagnose itself.
- Install companion app: installs or reinstalls the bundled compatibility companion with the
pm installshell command through the privileged process, then imports saved access choices and refreshes setup. - Remove companion app: removes the original Shizuku app or the compatibility companion with the
pm uninstallshell command through the privileged process, after verifying the installed app identity. - Replace original service: finds a running original server with the
psshell command, confirms it by reading process files with thecatshell command, and stops it with thekillshell command before replacement. - Diagnose running service: streams the running service log with the
logcatshell command run inside theshshell command through the privileged process to capture server logs for bug reports. - Update running service: launches the bundled service starter binary through the privileged process to replace the running service with the installed build.
Android APIs or commands used
pm installpm uninstallpscatkillshlogcat
Notable details
When the privileged install or removal is unavailable, the app falls back to the normal Android package installer and uninstaller screens to install or remove the companion manually. Companion install, repair and import are available only in the FOSS build when managed from the primary Android user, and are blocked while other Android users exist.
Changelog
What's new for version 0.8.2-rc0
What's Changed
- docs: reserve Porter's artwork, docs and store listing by @d4rken in https://github.com/d4rken-org/porter/pull/160
- feat(manager): replace Shizuku forks that use their own package name by @d4rken in https://github.com/d4rken-org/porter/pull/159
- ci: run release-prepare on ubuntu-24.04 by @d4rken in https://github.com/d4rken-org/porter/pull/161
- fix(manager): ask before the Play build turns on TV pairing by @d4rken in https://github.com/d4rken-org/porter/pull/164
- fix(manager): open Android's battery list from the Play build by @d4rken in https://github.com/d4rken-org/porter/pull/165
- docs: show a globe instead of flags in the language menu by @d4rken in https://github.com/d4rken-org/porter/pull/167
- docs: show Porter as the site name in search results by @d4rken in https://github.com/d4rken-org/porter/pull/169
- fix(ci): keep a UI dump that uiautomator wrote before crashing by @d4rken in https://github.com/d4rken-org/porter/pull/170
- feat(manager): option to turn off wireless debugging after starting by @d4rken in https://github.com/d4rken-org/porter/pull/172
- feat(manager): log why wireless debugging finds no port by @d4rken in https://github.com/d4rken-org/porter/pull/173
- fix(ci): recover the stranded permission prompt and dropped pairing digits by @d4rken in https://github.com/d4rken-org/porter/pull/176
- fix(manager): find wireless debugging on phones that repeat discovery by @d4rken in https://github.com/d4rken-org/porter/pull/177
- fix(ci): pin the emulator to 37.2.12 by @d4rken in https://github.com/d4rken-org/porter/pull/179
- test(manager): keep the permission prompt test's recompositions on the main thread by @d4rken in https://github.com/d4rken-org/porter/pull/180
- feat(manager): log why pairing from the in-app dialog failed by @d4rken in https://github.com/d4rken-org/porter/pull/182
Full Changelog: https://github.com/d4rken-org/porter/compare/v0.8.1-rc0...v0.8.2-rc0
Permissions
16 permissions requested