https://github.com/ganggreentempertatum/bytecap
Caido plugin to cap and split workspace files by size — ideal for proxy files/log uploads with file size limits.
https://github.com/ganggreentempertatum/bytecap
api-hacking appsec caido caido-extension caido-plugin hacker-tools web-hacking web-hacking-tool web-security-research
Last synced: 2 months ago
JSON representation
Caido plugin to cap and split workspace files by size — ideal for proxy files/log uploads with file size limits.
- Host: GitHub
- URL: https://github.com/ganggreentempertatum/bytecap
- Owner: GangGreenTemperTatum
- License: mit
- Created: 2025-08-11T00:38:18.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-23T23:05:58.000Z (6 months ago)
- Last Synced: 2025-10-24T00:07:13.802Z (6 months ago)
- Topics: api-hacking, appsec, caido, caido-extension, caido-plugin, hacker-tools, web-hacking, web-hacking-tool, web-security-research
- Language: Vue
- Homepage:
- Size: 2.83 MB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# Bytecap
_Caido plugin to cap and split workspace files by size — ideal for proxy and log file uploads with file size limits_
Brought to you by [@GangGreenTemperTatum](https://github.com/GangGreenTemperTatum), proud ambassador of the [Caido](https://caido.io/ambassadors) community!
[](https://github.com/GangGreenTemperTatum/Bytecap/network/members)
[](https://github.com/GangGreenTemperTatum/Bytecap/issues)
[](https://github.com/GangGreenTemperTatum/Bytecap/releases)
[](https://github.com/GangGreenTemperTatum/Bytecap/stargazers)
[](https://github.com/GangGreenTemperTatum/Bytecap/blob/main/LICENSE)
[Report Bug](https://github.com/GangGreenTemperTatum/Bytecap/issues) •
[Request Feature](https://github.com/GangGreenTemperTatum/Bytecap/issues)
*bytecap*
Bytecap is now available via the [Caido Plugin Library](https://caido.io/plugins)! 🥳 Bytecap was [submitted to the Caido Plugin Library](https://github.com/caido/store/pull/41) and is approved, it will be available for installation directly from the Caido plugin store page.
---
- [Bytecap](#bytecap)
- [Overview](#overview)
- [Quick Start](#quick-start)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Method 1 - Install directly in Caido (recommended):](#method-1---install-directly-in-caido-recommended)
- [Method 2 - Install from source (without auto-updates):](#method-2---install-from-source-without-auto-updates)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
- [Star History](#star-history)
## Overview
Bytecap is a Caido plugin that helps you monitor and manage workspace file sizes. Perfect for scenarios where you need to upload proxy/logs or data files with strict size limits (IE certain pentesting platforms), Bytecap provides real-time file size monitoring with configurable thresholds and warnings.
> Come [join](https://discord.com/invite/Xkafzujmuh) the **awesome** Caido discord channel and come speak to me about Bytecap in it's [dedicated channel](https://discord.com/channels/843915806748180492/1407063905511145653)!
**Warning**: Bytecap has been reported as not working well on Windows systems (still under investigation). It is recommended to use Bytecap on Linux or macOS for the best experience.
---
## Quick Start
### Prerequisites
- Caido (latest version)
- Node.js and pnpm (for development)
### Installation
### Method 1 - Install directly in Caido (recommended):
1. Open Caido, navigate to the `Plugins` sidebar page and then to the `Community Store` tab
2. Find `Bytecap` and click `Install`
3. Done! 🎉
### Method 2 - Install from source (without auto-updates):
1. **Clone the repository:**
```bash
git clone https://github.com/GangGreenTemperTatum/Bytecap.git
cd Bytecap
```
2. **Install dependencies:**
```bash
pnpm install
```
3. **Build the plugin:**
```bash
pnpm build
```
4. **Install in Caido:**
- Open Caido
- Go to Settings > Plugins
- Click "Install from file"
- Select the built plugin file from the `dist/` directory
### Usage
1. **Access Bytecap:**
- After installation, find "Bytecap" in your Caido sidebar
- Click to open the file size monitoring interface
2. **Configure your settings:**
- Use the slider to set your file size threshold (1-20GB)
- Enable additional warnings for 75% and 90% thresholds
- Click "Apply Settings" to activate threshold monitoring
- Click "Refresh Files" to scan your workspace
3. **Monitor your files:**
- View all workspace files in the sortable table
- Check color-coded status indicators
- Review alerts and warnings for files exceeding threshold
*bytecap notification*
*bytecap notification*
## Contributing
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Star History
[](https://star-history.com/#GangGreenTemperTatum/Bytecap&Date)
---
Made with ❤️ for the Caido community and angry pentesters