fowl: Forward Over Wormhole, Locally

fowl is a tool that utilizes Magic Wormhole and its Dilation feature to forward arbitrary streams over an easy-to-setup yet secure connection.

There are no logins, no identities and the server can’t see content because it’s end-to-end (E2E) encrypted. Additionally, the server is often not involved in the “bulk transport” of bytes at all as the protocol prefers P2P connections.

Conceptually, this is similar to ssh -R and ssh -L.

Sound interesting? Read on!

• Forward over Wormhole, Locally (fowl)
  • 🤔 Motivation
  • 🦃 What?
  • ✍ Motivational Example
  • 🐃 Why is This Particular Yak Being Shorn?
  • ⌨ How Does It Work?
  • 👤 Who Should Use This?
  • 💼 Installation and Basic Usage
  • 💬 Hello World: Chat!
  • 📦 Other Platforms
  • 🚚 Stability and Releases
  • 🧙 Contributors
• fowld versus fowl
  • High-Level Overview
  • Philsophy of Commands
• fowl Usage
  • Overview of a Session
  • Common fowl Options: An Example
  • Common fowl Options
  • Starting a Session
  • Joining a Session
• fowld Usage
• fowl-tui Usage
• The fowld Frontend Protocol
  • The "kind" Key
  • Input: kind: allocate-code
  • Input: kind: set-code
  • Input: kind: local
  • Input: kind: remote
  • Input: kind: grant-permission
  • Input: kind: danger-disable-permission-check
  • Output: kind: listening
  • Output: kind: error
  • Output: kind: welcome
  • Output: kind: code-allocated
  • Output: kind: peer-connected
  • Output: kind: bytes-in
  • Output: kind: bytes-out
  • Output: kind: local-connection
  • Output: kind: incoming-connection
• Dilation Application Protocol
  • Overall Philosophy
  • General Message Format
  • Control Subchannel
  • Forwarding Subchannel