A GNOME Shell extension that provides a Quick Settings toggle to manage the Gnirehtet service for reverse tethering Android devices over USB.
- Toggle Gnirehtet service on/off from GNOME Quick Settings.
- Displays the number of connected Android devices.
- Notifications for device connections/disconnections and errors.
- Automatic detection if Gnirehtet is already running externally.
- GNOME Shell (declared compatible with GNOME 46–50)
- Gnirehtet installed and available in PATH (see Gnirehtet repository for installation).
- Android device with USB debugging enabled.
- Download the latest
gnirehtet-gnome@mateusvmv.shell-extension.zipfrom the Releases page. - Install the extension using:
gnome-extensions install gnirehtet-gnome@mateusvmv.shell-extension.zip - Restart GNOME Shell (Alt+F2, type
r, Enter) or log out and back in. - Enable the extension using GNOME Extensions app or
gnome-extensions enable gnirehtet-gnome@mateusvmv.shell-extension.zip.
- Open GNOME Quick Settings (top-right corner).
- Look for the "Gnirehtet" toggle with a network icon.
- Toggle it to start/stop the Gnirehtet service.
- The subtitle shows the status: number of active devices or "Started externally" if managed elsewhere.
- Ensure Gnirehtet is installed and
gnirehtetcommand is in PATH. - Check system logs for errors if the service fails to start.
- Port 31416 must be free; the extension handles conflicts by notifying and stopping.
This project is licensed under the GPL-3.0 License. See LICENSE file for details.
Contributions are welcome! Please open issues or pull requests on the repository.