{"id":13490146,"url":"https://github.com/robinpaulson/SimpleRT","last_synced_at":"2025-03-28T05:32:04.089Z","repository":{"id":38450503,"uuid":"64512332","full_name":"robinpaulson/SimpleRT","owner":"robinpaulson","description":"Simple Reverse Tethering utility for Android","archived":false,"fork":false,"pushed_at":"2022-12-20T06:09:51.000Z","size":14172,"stargazers_count":905,"open_issues_count":24,"forks_count":101,"subscribers_count":33,"default_branch":"master","last_synced_at":"2024-08-01T19:33:20.821Z","etag":null,"topics":["android","libusb","reverse-tethering","vpn"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robinpaulson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-07-29T21:47:41.000Z","updated_at":"2024-07-24T17:54:47.000Z","dependencies_parsed_at":"2023-01-29T23:46:00.937Z","dependency_job_id":null,"html_url":"https://github.com/robinpaulson/SimpleRT","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinpaulson%2FSimpleRT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinpaulson%2FSimpleRT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinpaulson%2FSimpleRT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinpaulson%2FSimpleRT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robinpaulson","download_url":"https://codeload.github.com/robinpaulson/SimpleRT/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222351196,"owners_count":16970636,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","libusb","reverse-tethering","vpn"],"created_at":"2024-07-31T19:00:41.587Z","updated_at":"2024-10-31T03:31:15.131Z","avatar_url":"https://github.com/robinpaulson.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"# SimpleRT\nAndroid component: [![Build and release](https://github.com/robinpaulson/SimpleRT/actions/workflows/android.yml/badge.svg)](https://github.com/robinpaulson/SimpleRT/actions/workflows/android.yml)\n\n[\u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/0/0d/Get_it_on_F-Droid.svg/200px-Get_it_on_F-Droid.svg.png\" style=\"float: left; padding-right: 10px;\"\u003e](https://f-droid.org/repository/browse/?fdid=com.viper.simplert)\n\nReverse [Tethering](https://en.wikipedia.org/wiki/Tethering) utility for Android.\n\nProvides a way to share a computer's internet connection with an Android device via a USB cable.\n\nDevelopment is still in progress, bugs and errors can occur.\n\n```\nFIRST RUN: check out -h option\n   simple-rt -h\n   usage: sudo ./simple-rt [-h] [-i interface] [-n nameserver|\"local\" ]\n   default params: -i eth0 -n 8.8.8.8\n```\n\n```\nIMPORTANT\n   If you have any issues with this tool, please, provide some logs:\n   - run util in debug mode (-d), connect your device\n   - run \"ip addr show\"\n   - run \"ip route show\"\n   - store this output into issue ticket on github\n```\n\n### No root or adb required\n\n## Full Linux and macOS support. Windows version is being researched.\n\n   Current version features:\n   - Multi-tether. It is possible to connect several android devices into one virtual network\n   - DNS server can be specified (custom or system one).\n\nThe SimpleRT utility consists of 2 parts:\n\n- Android part:\n\n   Implemented as a standalone service, no gui, no activities\n\n   Dependencies:\n   - Android 4.0 and higher.\n\n   Build system based on gradle + gradle experimental android plugin (supporting ndk). To build, both sdk \u0026 ndk are required.\nCreate local.properties file in root dir, it should look like this:\n   ```\n   ndk.dir=/home/viper/Android/Sdk/ndk-bundle\n   sdk.dir=/home/viper/Android/Sdk\n   ```\n   build:\n   ```\n   ./gradlew assembleDebug\n   ```\n   app/build/outputs/apk/app-debug.apk is your apk.\n\n   ## Now available in [f-droid](https://f-droid.org/repository/browse/?fdfilter=simplert\u0026fdid=com.viper.simplert)\n   A prebuilt apk can also be found under `Downloads` at the [Github releases](https://github.com/iteratec/SimpleRT/releases)\n   tab.\n\n- Desktop part:\n\n   Dependencies:\n   - libusb-1.0\n   - libresolv (usually already present in both linux and macos)\n   - tuntap kernel module (linux version), utun (macos version, builtin)\n\n   before build (debian-based example):\n   ```\n   sudo apt install build-essential pkg-config libusb-1.0-0-dev\n   ```\n\n   Makefile is universal for all platforms, just type \"make \u0026\u0026 make install\" to install it in prefix /usr/local and\n   check /usr/local/sbin is in your PATH-variable.\n   If you want to change the prefix path eg. to install it in /usr instead of /usr/local you can\n   type \"make prefix=/usr \u0026\u0026 make prefix=/usr install\".\n   If you don't want to install but just run it from within build directory you can type \"make iface_up_sh_path=.\".\n\nUsage:\n\n- run console util as root (sudo simple-rt). The iface_up.sh file needs to be present in the application folder.\n- connect your android device\n\nFirst connection requires some trivial steps:\n\n![First step](screens/accessory.png)\n\n![Second step](screens/vpn.png)\n\n![Third step](screens/connected.png)\n\nIssues: Some apps do not recognize the reverse tethered internet connection due to ConnectivityManager policy. Leave the WiFi or mobile data connection active, the connection through SimpleRT will be prioritised.\n\nPartially uses code from [linux-adk](https://github.com/gibsson/linux-adk), which is licensed under the GNU GPLv2 or later. This project is under the GNU GPLv3 or later.\n\n##### License: GNU GPL v3\n\n```\nSimpleRT: Reverse tethering utility for Android\nCopyright (C) 2016 Konstantin Menyaev\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobinpaulson%2FSimpleRT","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobinpaulson%2FSimpleRT","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobinpaulson%2FSimpleRT/lists"}