scorpiox-thunderbolt4network

Raw Ethernet file transfer over Thunderbolt 4 (macOS). Bypasses TCP/IP entirely and pushes data as raw Ethernet frames over the Thunderbolt 4 bridge interface, delivering near-wire-speed transfers between two Macs connected with a Thunderbolt cable.

macOS ARM64

Flags & Options

Flag	Short	Description	Takes Value
`--fast`	—	Enable zero-copy fast mode for maximum throughput	No
`--help`	`-h`	Show help message and exit	No
`--version`	`-v`	Show version information	No

Usage Examples

Send a file to another Mac

# On the receiving Mac — start listening

$ scorpiox-thunderbolt4 receive

# On the sending Mac — transfer a file

$ scorpiox-thunderbolt4 send ./project-backup.tar.gz

→ Detected bridge0 (Thunderbolt 4)

→ Sending project-backup.tar.gz (2.4 GB)

→ Transfer complete: 2.4 GB in 6.1s (3.15 Gbps)

Fast mode — zero-copy for maximum throughput

$ scorpiox-thunderbolt4 --fast send ./vm-image.raw

→ Zero-copy mode enabled (sendfile + BPF)

→ Sending vm-image.raw (32.0 GB)

→ Transfer complete: 32.0 GB in 82.4s (3.89 Gbps)

Transfer a directory (tar stream)

# Receiver

$ scorpiox-thunderbolt4 receive --output ~/Downloads/

# Sender — directory is automatically tar-streamed

$ scorpiox-thunderbolt4 send ./my-project/

→ Streaming directory my-project/ (1847 files, 680 MB)

→ Transfer complete: 680 MB in 1.8s (3.02 Gbps)

Check link status

$ scorpiox-thunderbolt4 status

Thunderbolt 4 Bridge: bridge0

Link speed: 40 Gbps (USB4/TB4)

MTU: 9000

Peer MAC: a4:83:e7:2f:00:1a

State: ready

Source & Build Info

Source File

scorpiox/scorpiox-thunderbolt4.c

Lines of Code

1,486

Dependencies

None

scorpiox-thunderbolt4network

Raw Ethernet file transfer over Thunderbolt 4 (macOS). Bypasses TCP/IP entirely and pushes data as raw Ethernet frames over the Thunderbolt 4 bridge interface, delivering near-wire-speed transfers between two Macs connected with a Thunderbolt cable.

Flags & Options

Usage Examples

Source & Build Info

Related Tools