View on GitHub


Intergalactic serial monitor for ESP8266 Deauther


Huhnitor Logo
An intergalactic serial monitor for the ESP8266 Deauther v3
Rust badge

New New New ✨

Check out for a web based serial monitor.
A great alternative that works with all Arduino projects and doesn’t need to be installed. You just need a compatible browser, like Chrome for desktop.

But no worries, it doesn’t replace this project. Huhnitor remains to be our terminal based serial monitor!


Please note that while this software can be used for other serial devices and projects, it is designed to be used with the ESP8266 Deauther Version 3.


Youtube Tutorial:
Huhnitor Installation Video Tutorial

  1. Go to the release page and download a binary for your OS from the latest release.
  2. Run it by simply double clicking it or via terminal ./huhnitor or sudo ./huhnitor
    Linux & Mac users will have to make the binary executable first by running sudo chmod +x huhnitor
  3. [Optional] Add it to the PATH variable for easy use in the terminal
  1. Install snap if it doesn’t already come with your Linux distribution.
  2. Open a terminal and type
    sudo snap install huhnitor --edge --devmode
  3. To start simply run sudo huhnitor in a terminal

If you get a huhnitor not found message, try adding snap to the PATH by running export PATH="$PATH:/snap/bin".

Using AUR on Arch Linux

  1. Open a terminal and type
    yay -S huhnitor
  2. To start simply run sudo huhnitor in a terminal
  1. Make sure Homebrew is installed
  2. Open a terminal and type
    brew tap spacehuhntech/huhnitor
    brew install huhnitor
    or as a one-liner: brew tap spacehuhntech/huhnitor && brew install huhnitor
  3. To start simply run huhnitor in a terminal

Pro tip: Homebrew can also be installed on Linux, and the Windows Subsystem for Linux.

Compiling it yourself

Precompiled binaries can be found at releases.
But if you want, you can compile the Huhnitor yourself:

  1. Install Rust using rustup
    Linux users will also need to run sudo apt install libudev-dev pkg-config
    Windows users have to install Visual C++ Build Tools 2019
  2. Download and unzip or git clone this repository
  3. In the root directory of the repo run cargo build --release, your binary will be located in target/release/ (you can use cargo run to start Huhnitor without compiling a binary)


The Huhnitor is designed to be as easy to use as possible:

  1. Open huhnitor
  2. Plug in your deauther
  3. Have fun using the command line interface of the ESP8266 Deauther :slightly_smiling_face:

If the huhnitor has issues connecting to your deauther, try running it as administrator or via sudo huhnitor.
You can also give a user permission to access the serial ports by running sudo usermod -a -G dialout <username>.

The Huhnitor can run scripts (a series of pre-written commands) if you enter huhn read [filename] once you are connected to a deauther. The file paths are relative to your current command line location (not the executable’s) and are essentially a series of newline separated deauther commands.

To stop running a command on the deauther, you can hit ctrl + c, which is in theory more convenient and should help to prevent accidental disconnects. This does, however, also mean that you cannot exit the Huhnitor with ctrl + c, therefore once a serial connection has been opened, entering exit must be used to exit the Huhnitor.


Argument Description
--help or -h print this help screen
--port or -p enter port as argument
--driver or -d open driver page
--no-auto or -a disable automatic port connect
--no-color or -c disable colored output
--no-welcome or -w disable welcome message


Your deauther is not detected when plugged in?
Make sure the USB connection is working. Some cables can only charge but not transmit data.
Depending on the serial chip that is used on the ESP8266 development board you have, you might need to install the right driver:

Not sure which one to install? A lot of ESP8266 based development boards use a chip from the CP210x family, try starting there.


Made with :heart: by Jamz with help from Selicre
in cooperation with Spacehuhn Technologies


This software is licensed under the MIT License. See the license file for details.