Metadata-Version: 2.4
Name: t-eth-er
Version: 1.3.2
Summary: Ethernet tethering for Linux - NAT a single device through an interface
License: MIT
Keywords: ethernet,iptables,nat,networking,tethering
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# tETHer - ethernet tethering
Tether one device to another over an ethernet interface on linux (rather than USB)

Tethering proxies one device through another devices internet connections. A common use case is to connect to a mobile phone over USB and then use its internet connection. tETHer does the same thing but via an ethernet connection such as an rj-45 cable.  This also allows forwarding

Unreviewed ai-generated code. But I am using it.

## Motivation
I had a camera which only supported wired connection. I did not want to run a long wire to a router and wireless bridges were moderately expensive so I decided to get this working with an old raspberry pi. I don't really like "infrastructure" because I forget how it works. I prefer tools which minimise the amount of infrastructure so I coded this.

## Alterantives and prior work
Use a wireless bridge.  Hand code the networking yourself using wireless. RaspAP is an image for raspberry pi to set up a wireless bridge it also supports port forwarding.

This is very similar to the idea of setting up an *access point*, but it has some additional features for port forwarding which are made easier if you are providing access or a single device.


## Installation
tETHer requires `nmap` `dnsmasq` and Linux. On a linux machine install them: `sudo apt install nmap dnsmasq` pipx.

You can then install with pipx: `pipx install t-eth-er`

## Usage
Set up dhcp and forwarding on eth0 so that if you plug in a device which uses DHCP it will connect to you and then via you to the rest of the network - including the internet.

`eth-tether eth0`

If you want to forward ports you can capture all the ports that the tethering machine has

`eth-tether eth0 --scan ports`

Then on subsequent files you can use the generated ports file

`eth-tether eth0 --ports ports`

To avoid requiring too many permissions, tETHer uses sudo to run privileged commands. You can allow your use to only run these commands or you can run the entire commadn with sudo. To get a sudoers file alowing these commands run `eth-tether eth0 --sudoers`


