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:

Downloads

Latest release version is Bit-Twist 3.8, released on July 6, 2023. For installation, follow the instructions in the README.md included in the package.

Linux:
bittwist-linux-3.8.tar.gz SHA256=728cc8aa0cfcadaac2423f43304155caaa83bf7e6edb94fc2c349a6cecbaef21

BSD:
bittwist-bsd-3.8.tar.gz SHA256=fd70db0c4bbeda155cb2cab4ca7c6ecccb59a511f02854b99663fa25c2b51ded

macOS:
bittwist-macos-3.8.tar.gz SHA256=d3abce2703406115f257765c40b75eb5f45f01fe61e42a2e77e38a93aece22d0

Windows (pre-compiled executable files included, Npcap installation is required):
bittwist-windows-3.8.zip SHA256=cd1389f088e5007e10b0af3d1ccd1b7b6f92a0d81fa5fce8081c6fa58e1c5fe0

Browse the source code: github.com/ayeowch/bittwist

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

Copyright (C) 2006 - 2023 Addy Yeow <ayeowch@gmail.com>

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.