Bit-Twist

Supported systems: Linux, BSD, macOS, and Windows.

Bit-Twist is a simple yet powerful libpcap-based Ethernet packet generator and packet editor. It is designed to complement tcpdump, which by itself has done a great job at capturing network traffic.

With Bit-Twist, you can now regenerate your captured traffic onto a live network! Packets are generated from tcpdump trace file (.pcap file). Bit-Twist also comes with a comprehensive trace file editor to allow you to change the contents of a trace file. Bit-Twist is designed for exceptional speed! Utilizing a standard laptop with Linux system, you can edit 10 million packets in less than 5 seconds, and send the packets onto a live network, achieving throughput levels that match the maximum line rate of your NIC.

Packet generator is useful in simulating networking traffic or scenario, testing firewall, IDS, and IPS, and troubleshooting various network problems.

Features

These are just a few significant features that makes Bit-Twist unique and stands out as one of the best Ethernet packet generator and packet editor package made available to the open source community.

Highly portable: Bit-Twist runs on Linux, BSD, macOS, and Windows.
Send multiple trace files indefinitely with set interval, packets per second, or line rate between 1 Mbps to 10 Gbps using built-in token bucket algorithm.
Comprehensive trace file editor to edit most fields in Ethernet, ARP, IPv4, IPv6, ICMPv4, ICMPv6, TCP, and UDP headers. Templates are also included to generate packets with these headers without needing an existing trace file.
Automatic header checksum correction (with option to disable).
Send packets with custom QoS bits to test classification and queuing features of switches and routers.
Send packets with uniformly distributed random numbers for port numbers, TCP sequence numbers, etc.
Append custom payload (e.g. copy of hex stream from Wireshark) to existing packets after a specific header, handy for testing new protocols.
Send packets with truncated or expanded length in bytes, facilitating incremental throughput testing.
Highly scriptable: With proper manipulation, you can turn Bit-Twist into a versatile packet generator and packet editor tooling to meet your network testing requirements.

For the complete feature list, see Bit-Twist man pages:

bittwist.1 - pcap based ethernet packet generator
bittwiste.1 - pcap capture file editor

Downloads

Latest release version is Bit-Twist 4.2, released on October 14, 2024. For installation, follow the instructions in the README.md included in the package.

Linux
bittwist-linux-4.2.tar.gz (executable files for x86_64 and aarch64 included) SHA256=76b3c4e6fab4b8bc268cf9dfcf2ffa78d53c60825efad9e50b08d00f72422c3d

BSD
bittwist-bsd-4.2.tar.gz SHA256=5165c86109402f1bc0a41945b9829fc924f3b790ae7d1cc0747e58bdee678a8f

macOS
bittwist-macos-4.2.tar.gz SHA256=6d11277638ae90d48370523ae62f2ed4176db1919fdd25ac7b7e2f46e3874083

Windows
bittwist-windows-4.1.zip (executable files included) SHA256=34351b49b2a52b501ea8f4f39a61b762f7f8aa7c567881357c54d7eaf1bb0f70 Npcap installation is required as prerequisite for Windows.

You may also download Bit-Twist from SourceForge.net File Releases for Bit-Twist. Older releases are available here for regression testing.

License

SPDX-License-Identifier: GPL-2.0-or-later

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Contact

Please do not hesitate to reach out to me at ayeowch@gmail.com for any inquiries or bug reports.

Prior to submitting your bug report, kindly ensure that you are using the latest version. For more information on known bugs, please refer to the BUGS section in the Bit-Twist manual pages.

If you are interested in leveraging Bit-Twist for your business needs, feel free to discuss commercial licensing options with me via email.

Maintainer

Bit-Twist project is maintained and developed by Addy Yeow.