This repository is a curated collection of standalone, single-purpose Bash utilities. Each script is self-contained and designed to solve a specific task securely and efficiently using best practices in Bash scripting.
.
├── LICENSE
├── docs/
│ ├── CAPTURE_TRAFFIC_README.md
│ ├── LOGGER_README.md
│ ├── SAFE_SOURCE_README.md
│ ├── LICENSE
├── scripts/
│ ├── capture_traffic.sh
│ ├── logger.sh
│ ├── safe_source.sh
A utility for capturing bidirectional TCP traffic between two IPs and ports using tshark.
- Logs traffic with timestamps, IP addresses, ports, and application payloads.
- Useful for debugging or analyzing network communication in real-time.
2. Logger
A shell logging utility that provides structured, color-coded log output functions (e.g., info, warn, error).
- Designed for use in secure Bash scripts.
- Easily portable into any Bash project.
3. Safe Source
A script and library to safely source other shell scripts and revert their changes to the environment.
- Tracks and undoes changes to variables, functions, aliases, and exports.
- Useful for modular scripting or testing.
Each script is designed to be:
- Modular and easy to reuse.
- Secure, passing ShellCheck and formatting tools.
- Documented with a dedicated README in the
docs/directory.
You can find usage, options, examples, and error handling behavior in each script’s linked README.
This repository is licensed under the MIT License. Each script may also include its own header-based licensing or author notes.
These scripts are meant to be lightweight and purpose-built. Feel free to fork and modify them for your own workflows or submit a PR for small fixes.
Happy scripting! 🐚