Jacknet / dreampi

[ARCHIVED, moved to samicrusader/notdreamnorpi] A Linux environment-agnostic fork of the DreamPi dial-up bridge for use with other devices

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

dreampi

An environment-agnostic fork of DreamPi which can run on most GNU/Linux flavors that can run Python 2.7, optimized for use with devices outside of a Dreamcast.

Prerequisites

Ensure your distro's kernel is compiled to support PPP and can utilize the PPP daemon (pppd). Otherwise, a network would not be established between the host and client systems and your connection will terminate.

Install the following dependencies through PIP:

  1. pyserial
  2. sh
  3. python-iptables
  4. miniupnpc

Set a XTABLES_LIBDIR environment variable to the location containing your xtables libraries (e.g. /usr/lib64/xtables/).

This program will use dnsmasq as the DNS daemon. More modern variants of GNU/Linux use systemd-resolved, which may end up reserving certain service ports. Stop other name resolution services before starting the DreamPi service, leaving just dnsmasq during execution.

Copy the dnsmasq.conf file in the etc directory of this repo to your target system's /etc/ directory. Make sure to back up any existing dnsmasq.conf in there or rename it by appending a .bak to the file name.

Usage

As root, operate the DreamPi service using either the following commands:
./dreampi.py [start|stop|restart] interface
python(2) dreampi.py [start|stop|restart] interface

The interface parameter corresponds to your network device, such as eth0 or wlan0. Check ifconfig to know your network device's name.

You do not need to define your network interface if you are stopping the service.


Original by @Kazade

A daemon that creates a bridge between a Dreamcast's Dial-up Modem, and the Internet via the Pi

About

[ARCHIVED, moved to samicrusader/notdreamnorpi] A Linux environment-agnostic fork of the DreamPi dial-up bridge for use with other devices

License:MIT License


Languages

Language:Python 81.0%Language:C++ 17.8%Language:Shell 1.1%