byedpictl

Very simple deep packet inspection bypass utility for Linux. Supports both command-line and graphical interfaces.

Uses byedpi for processing and hev-socks5-tunnel for network tunneling.

Still in the progress of early development, so there are no stable releases yet.

Install

Download the latest archive and unpack it.

Then use the script in the unpacked directory to install the project:

$ sudo ./make.sh install

Update

The very same make.sh script can be used to update the project, leaving the already existing configuration intact.

First, you need to get the latest archive and unpack it.

Then use the script in the unpacked directory to safely update the project:

$ sudo ./make.sh update

Remove

Use the make.sh script to remove the project:

$ sudo ./make.sh remove

Usage

Command Line

Get all the available information about utility commands usage with:

$ byedpictl help

Tunneling

Control the background tunneling.

• Start and stop the tunneling with:

  # Start
  $ byedpictl tun start
  
  # Stop
  $ byedpictl tun stop

• Get status of background tunneling with:

  $ byedpictl tun status

Graphical Interface

This project also supports a GUI mode (based on Zenity) for some basic interactions, like starting/stopping the tunneling and so on. A desktop entry will be created on initial project installation and can be accessed on any XDG-compliant desktop environment to start the graphical menu.

To run the graphical interface on the target system, zenity must be installed. Most distributions provide it out of the box.

Configuration

DPI desync (bypass) approaches can be modified by altering the contents of /etc/byedpictl/desync.conf file.

Debugging

Logs are available in /var/log/byedpictl directory.

Possible issues

Tunnel after suspend

Tunneling will break after waking machine from suspend (sleep) state. To restore the functionality you should restart the tunnel with the command below:

$ byedpictl tun restart