42 lines
2 KiB
Markdown
42 lines
2 KiB
Markdown
# Burrow
|
|
|
|
  
|
|
|
|
Burrow is an open source tool for burrowing through firewalls, built by teenagers at [Hack Club](https://hackclub.com/).
|
|
|
|
`burrow` provides a simple command-line tool to open virtual interfaces and direct traffic through them.
|
|
|
|
## Contributing
|
|
|
|
Burrow is fully open source, you can fork the repo and start contributing easily. For more information and in-depth discussions, visit the `#burrow` channel on the [Hack Club Slack](https://hackclub.com/slack/), here you can ask for help and talk with other people interested in burrow! Checkout [GETTING_STARTED.md](./docs/GETTING_STARTED.md) for build instructions and [GTK_APP.md](./docs/GTK_APP.md) for the Linux app.
|
|
|
|
The project structure is divided in the following folders:
|
|
|
|
```
|
|
Apple/ # Xcode project for burrow on macOS and iOS
|
|
burrow/ # Higher-level API library for tun and tun-async
|
|
burrow-gtk/ # GTK project for burrow on Linux
|
|
tun/ # Low-level interface to OS networking
|
|
src/
|
|
tokio/ # Async/Tokio code
|
|
unix/ # macOS and Linux code
|
|
windows/ # Windows networking code
|
|
```
|
|
|
|
## Installation
|
|
|
|
To start burrowing, download the latest release build in the release section.
|
|
|
|
## Hack Club
|
|
|
|
Hack Club is a global community of high-school hackers from all around the world! Start your own Hack Club, attend an upcoming hackathon or join our online community at [hackclub.com](https://hackclub.com/).
|
|
|
|
## License
|
|
|
|
Burrow is open source and licensed under the [GNU General Public License v3.0](./LICENSE.md)
|
|
|
|
## Contributors
|
|
|
|
<a href="https://github.com/hackclub/burrow/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=hackclub/burrow" />
|
|
</a>
|