Gnirehtet (v2.5.1)
This project provides reverse tethering over adb for Android: it
allows devices to use the internet connection of the computer they are plugged
on. It does not require any root access (neither on the device nor on the
computer). It works on GNU/Linux, Windows and Mac OS.
Currently, it relays TCP and UDP over IPv4 traffic, but it does not
support IPv6 (yet?).
This project is not actively maintained anymore, only major blockers (like
build issues) are fixed. It should still work, though.
Flavors
Two implementations of Gnirehtet are available:
- one in Java;
- one in Rust.
Which one to choose?
Use the Rust implementation. The native binary consumes less CPU and memory,
and does not require a Java runtime environment.
The relay server of Gnirehtet was initially only implemented in Java. As a
benefit, the same "binary" runs on every platform having Java 8 runtime
installed. It is still maintained to provide a working alternative in case of
problems with the Rust version.
Requirements
The Android application requires at least API 21 (Android 5.0).
For the Java version only, Java 8 (JRE) is required on your computer. On
Debian-based distros, install the package openjdk-8-jre.
adb
You need a recent version of adb (where adb reverse is implemented, it
works with 1.0.36).
It is available in the Android SDK platform tools.
On Debian-based distros, you can alternatively install the package
android-tools-adb.
On Windows, if you need adb only for this application, just download the
platform-tools and extract the following files to the
gnirehtet directory:
adb.exeAdbWinApi.dllAdbWinUsbApi.dll
Make sure you enabled adb debugging on your device(s).
Get the app
Homebrew
If you use Homebrew, getting up and running is very quick.
To install the Rust version:
brew install gnirehtet
Download
Download the latest release in the flavor you want.
Rust
- Linux:
gnirehtet-rust-linux64-v2.5.1.zip
(SHA-256: dee55499ca4fef00ce2559c767d2d8130163736d43fdbce753e923e75309c275)
- Windows:
gnirehtet-rust-win64-v2.5.1.zip
(SHA-256: 7f5b1063e7895182aa60def1437e50363c3758144088dcd079037bb7c3c46a1c)
- MacOS:
gnirehtet-rust-macos64-v2.2.1.zip
(old release)
(SHA-256: 902103e6497f995e1e9b92421be212559950cca4a8b557e1f0403769aee06fc8)
Then extract it.
The Linux and MacOS archives contain:
The Windows archive contains:
gnirehtet.apkgnirehtet.exegnirehtet-run.cmd
Java
- All platforms:
gnirehtet-java-v2.5.1.zip
(SHA-256: 816748078fa6a304600a294a13338a06ac778bcc0e57b62d88328c7968ad2d3a)
Then extract it. The archive contains:
gnirehtet.apkgnirehtet.jargnirehtetgnirehtet.cmdgnirehtet-run.cmd
Run (simple)
Note: On Windows, replace ./gnirehtet by gnirehtet in the following
commands.
The application has no UI, and is intended to be controlled from the computer
only.
If you want to activate reverse tethering for exactly one device, just execute:
./gnirehtet run
Reverse tethering remains active until you press Ctrl+C.
On Windows, for convenience, you can double-click on gnirehtet-run.cmd
instead (it just executes gnirehtet run, without requiring to open a
terminal).
The very first start should open a popup to request permission:
A "key" logo appears in the status bar whenever Gnirehtet is active:
Alternatively, you can enable reverse tethering for all connected devices
(present and future) by calling:
./gnirehtet autorun
Run
You can execute the actions separately (it may be useful if you want to reverse
tether several devices simultaneously).
Start the relay server and keep it open:
./gnirehtet relay
Install the apk on your Android device:
./gnirehtet install [serial]
In another terminal, for each client, execute:
./gnirehtet start [serial]
To stop a client:
./gnirehtet stop [serial]
To reset the tunnel (useful to get the connection back when a device is
unplugged and plugged back while gnirehtet is active):
./gnirehtet tunnel [serial]
The serial parameter is required only if adb devices outputs more than one
device.
For advanced options, call ./gnirehtet without arguments to get more details.
Run manually
The gnirehtet program exposes a simple command-line interface that executes
lower-level commands. You can call them manually instead.
To start the relay server:
./gnirehtet relay
To install the apk:
adb install -r gnirehtet.apk
To start a client:
adb reverse localabstract:gnirehtet tcp:31416
adb shell am start -a com.genymobile.gnirehtet.START \
-n com.genymobile.gnirehtet/.GnirehtetActivity
To stop a client:
adb shell am start -a com.genymobile.gnirehtet.STOP \
-n com.genymobile.gnirehtet/.GnirehtetActivity
Environment variables
ADB defines a custom path to the adb executable:
ADB=/path/to/my/adb ./gnirehtet run
GNIREHTET_APK defines a custom path to gnirehtet.apk:
GNIREHTET_APK=/usr/share/gnirehtet/gnirehtet.apk ./gnirehtet run
Why gnirehtet?
rev <<< tethering
(in Bash)
Developers
Read the developers page.
Licence
Copyright (C) 2017 Genymobile
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Articles
- Introducing “gnirehtet”, a reverse tethering tool for Android (French version)
- Gnirehtet 2: our reverse tethering tool for Android now available in Rust
- Gnirehtet rewritten in Rust (French version)
