VirtualNet

Choose what each app sees: Wi-Fi, mobile data, or both.

An open-source Xposed module for Android 9 and up, by DroidRooter.

This repository is the Xposed module listing for VirtualNet. Source code, issues and full documentation are at github.com/saadnahid7/VirtualNet.

Some apps only work, or only download, when they think you are on Wi-Fi. Others insist on mobile data. VirtualNet lets you decide, per app, what the app is told about your connection, without changing the connection itself.

• A phone on mobile data can look like it is on Wi-Fi to one app.
• A phone on Wi-Fi can look like it is on mobile data to another.
• Everything else on the phone sees the truth.

Your real traffic never changes. Only the answers an app gets when it asks "what am I connected to?" change.

• Features
• Modes
• Coverage: system framework or inside the app
• Requirements
• Installation
• Usage
• What it covers
• Compatibility
• Limits
• FAQ
• Lab app
• Building
• Project layout
• Open source
• Contributing
• Disclaimer
• Acknowledgements
• From DroidRooter
• License

• Per-app control. Pick Wi-Fi, Data, Both or Off for each app in one list. Changes apply live, with no reboot.
• One coherent identity. SSID, router MAC, local IP and range, gateway, DNS, signal, link speed, frequency, mobile type and interface all come from one editable profile, so an app that cross-checks sees a consistent network.
• System-level coverage. Hooks inside system_server and the phone process cover every app you pick, callbacks included, without scoping each app.
• Inside-the-app coverage. Optional hooks in a scoped app also cover socket addresses, network interfaces and Wi-Fi scan results.
• Choose your layer. A switch selects System, Apps or Both.
• Small and quiet. About 120 KB, no network permission, no ads, no analytics, no accounts.
• Verifiable. A detector app (built from source) shows exactly what an app would see, so you can check a change in seconds.

VirtualNet has two layers. A switch on the main screen chooses which one works.

Use Apps if you would rather not touch the system framework, or on a ROM where the system layer does not attach. Android 9 defaults to Apps.

• A rooted device with an LSPosed-compatible framework that supports the modern libxposed API 102, such as Vector or a recent LSPosed.
• Android 9 or newer (API 28 and up). See Compatibility for what has been verified.

1. Download the latest APK from Releases and install it.
2. Open Vector or LSPosed, enable VirtualNet, and add System Framework and Phone Services to its scope. VirtualNet offers this on first launch.
3. Restart the device, or its framework, once so the system hooks load.
4. Open VirtualNet and pick a mode for an app. No restart is needed after that.

Prefer to work only inside apps? Set Coverage to Apps, then scope each app instead.

1. Open VirtualNet and look at the status pill. Active means the framework is connected.
2. Tap a mode on any app row: Wi-Fi, Data, Both or Off.
3. Open the app you changed. If it was already running, close it once so it asks again.
4. To change what the fake network looks like, tap a profile card and edit it.

The recommendation banner has a Hide button if you do not want it.

"Verified" means the Wi-Fi, Data, Both and Off modes were checked with the Lab app on a rooted Vector setup, for both the system layer and the inside-the-app layer. Details are in docs/TESTING.md.

• Anything outside the Java framework sees the real network: raw sockets, native code and server-side checks such as your public IP, latency or carrier attestation.
• Both mode adds a stand-in cellular network. A callback registered for a cellular request does not fire for it.
• Status bar and quick settings are unchanged.
• After installing or updating the module, restart the framework once so the system hooks reload.
• Android 9 is unverified, see above.

Does it change my real connection? No. It only changes what selected apps are told.

Will it make a Wi-Fi-only download work over mobile data? The app will believe it is on Wi-Fi and proceed. The data still uses your mobile connection.

Do I have to add every app to scope? Not with System or Both coverage. Add an app to scope only if you want socket and interface checks covered too.

Why is nothing happening? Check that the status pill says Active, the module is enabled, System Framework and Phone Services are in scope, and the framework was restarted after installing.

Can it hide that I use a VPN? It leaves VPN transports alone.

lab/ holds a small detector called VirtualNet Lab. It is a development tool and is not shipped in releases. Build it from source (./gradlew :lab:assembleDebug) if you want to check what an app would see. It reads the connection through every route an app can use, prints a verdict (Wi-Fi, mobile or both) and logs one line per probe under the tag VNL. Set a mode for it like any other app to see the effect.

You need JDK 17 or newer and the Android SDK with platform 37.

./gradlew :app:assembleRelease :lab:assembleRelease

The release build is unsigned unless .local/signing.properties exists. The test scripts in scripts/ drive rooted emulators and devices.

app/       the module and its settings app
  config/    modes, coverage, profile, settings storage
  hooks/     module entry point
    common/    shared reflection and object shaping
    app/       hooks inside a scoped app
    system/    hooks in system_server and the phone process
  ui/        screens
lab/       the detector app
docs/      testing notes, screenshots
scripts/   emulator and device test harness
fastlane/  store listing text and images

VirtualNet is free and open source under the MIT license. The module, the settings app, the Lab detector, the test scripts and the store listing are all in this repository, and releases are built from it. There is no closed part, no tracking and no account. Read it, audit it, fork it.

Issues and pull requests are welcome. Please read CONTRIBUTING.md first. If a hook fails on your device, open an issue with your Android version, ROM, framework and the output of the Lab app.

VirtualNet is meant for privacy, testing and getting your own apps to behave the way you want. You are responsible for how you use it. Do not use it to break an app's terms, get around paid services or defraud anyone. The software is provided as is, without warranty.

• libxposed for the modern Xposed API and service library.
• LSPosed and Vector for the frameworks it runs on.

VirtualNet is a project of DroidRooter, a small team building tools for rooted Android.

• Website: droidrooter.com
• Telegram: @DroidRooter
• Facebook: facebook.com/droidrooter
• DRVCAM, DroidRooter's Virtual Camera: droidrooter.com/drvcam feeds your own video or images to apps in place of the camera, on rooted Android 9 to 17.

If VirtualNet helps you, star the repo and follow DroidRooter for more.

MIT © DroidRooter