{"id":24599665,"url":"https://github.com/sammwyy/MikuMikuBeam","last_synced_at":"2025-10-05T20:31:33.297Z","repository":{"id":273303947,"uuid":"919237944","full_name":"sammwyy/MikuMikuBeam","owner":"sammwyy","description":"An open-source network stresser tool but it's Hatsune Miku","archived":false,"fork":false,"pushed_at":"2025-02-23T04:11:31.000Z","size":6954,"stargazers_count":4676,"open_issues_count":49,"forks_count":335,"subscribers_count":28,"default_branch":"main","last_synced_at":"2025-05-21T00:04:05.443Z","etag":null,"topics":["ddos","ddos-attack-tools","ddos-attacks","ddos-tool","ddoser","hatsune-miku","miku","stresses"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sammwyy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-20T02:45:30.000Z","updated_at":"2025-05-20T18:20:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"91b38a37-0069-4426-bf94-d3c64fa54c4f","html_url":"https://github.com/sammwyy/MikuMikuBeam","commit_stats":null,"previous_names":["sammwyy/mikumikubeam"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sammwyy/MikuMikuBeam","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sammwyy%2FMikuMikuBeam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sammwyy%2FMikuMikuBeam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sammwyy%2FMikuMikuBeam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sammwyy%2FMikuMikuBeam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sammwyy","download_url":"https://codeload.github.com/sammwyy/MikuMikuBeam/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sammwyy%2FMikuMikuBeam/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278513239,"owners_count":25999430,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ddos","ddos-attack-tools","ddos-attacks","ddos-tool","ddoser","hatsune-miku","miku","stresses"],"created_at":"2025-01-24T13:06:43.773Z","updated_at":"2025-10-05T20:31:33.292Z","avatar_url":"https://github.com/sammwyy.png","language":"TypeScript","funding_links":[],"categories":["Go","TypeScript"],"sub_categories":[],"readme":"# Miku Miku Beam 💥⚡ (Network Stresser)\r\n\r\nA fun and visually appealing stress testing server with a **Miku-themed** frontend, where you can configure and run attacks while enjoying a banger song in the background! 🎤✨\r\n\r\n![Screenshot](docs/screenshot.png)\r\n\r\n## Features 🎉\r\n\r\n- 🐳 **Docker Ready**: MMB is ready to be built and run in a Docker container.\r\n- 🌐 **Real-time Attack Visualization**: View your attack’s progress and statistics in real-time as it runs. 🔥\r\n- 🎶 **Miku-themed UI**: A cute and vibrant design with Miku’s vibe to make the process more fun. Includes a banger song to keep you pumped! 🎧\r\n- 🧑‍💻 **Configurable Attack Parameters**: Easily set the attack method, packet size, duration, and packet delay via the frontend interface.\r\n- 🛠️ **Worker-Based Attack Handling**: The server processes attacks in separate workers for optimal performance and scalability.\r\n- 📊 **Live Stats**: Track the success and failure of each attack in real-time. See how many packets are sent and whether they succeed or fail.\r\n- 🖼️ **Aesthetic Design**: A visually cute interface to make your experience enjoyable. 🌸\r\n- 📡 **Attack Methods:**:\r\n  - `HTTP Flood` - Send random HTTP requests\r\n  - `HTTP Bypass` - Send HTTP requests that mimics real requests (Redirects, cookies, headers, resources...)\r\n  - `HTTP Slowloris` - Send HTTP requests and keep the connection open\r\n  - `Minecraft Ping` - Send Minecraft ping/motd requests\r\n  - `TCP Flood` - Send random TCP packets\r\n\r\n## Setup 🛠️\r\n\r\n### Prerequisites 📦\r\n\r\nMake sure you have the following installed:\r\n\r\n- Node.js (v14 or above) 🌱\r\n- npm (Node Package Manager) 📦\r\n\r\n### Development Mode 🔧\r\n\r\n1. Clone this repository:\r\n\r\n   ```bash\r\n   git clone https://github.com/sammwyy/mikumikubeam.git\r\n   cd mikumikubeam\r\n   ```\r\n\r\n2. Install the required dependencies:\r\n\r\n   ```bash\r\n   npm install\r\n   ```\r\n\r\n3. Create the necessary files:\r\n   - `data/proxies.txt` - List of proxies.\r\n   - `data/uas.txt` - List of user agents.\r\n\r\n4. Run the server in development mode:\r\n\r\n   ```bash\r\n   npm run dev\r\n   ```\r\n\r\n   - The **frontend** runs on `http://localhost:5173`.\r\n   - The **backend** runs on `http://localhost:3000`.\r\n\r\n---\r\n\r\n### Production Mode 💥\r\n\r\n1. Clone the repository and navigate to the project directory:\r\n\r\n   ```bash\r\n   git clone https://github.com/sammwyy/mikumikubeam.git\r\n   cd mikumikubeam\r\n   ```\r\n\r\n2. Install the dependencies:\r\n\r\n   ```bash\r\n   npm install\r\n   ```\r\n\r\n3. Build the project:\r\n\r\n   ```bash\r\n   npm run build\r\n   ```\r\n\r\n4. Start the server in production mode:\r\n\r\n   ```bash\r\n   npm run start\r\n   ```\r\n\r\n   In production mode, both the **frontend** and **backend** are served on the same port (`http://localhost:3000`).\r\n\r\n\u003e Don't forget to add the necessary files `data/proxies.txt` and `data/uas.txt`.\r\n\r\n## Usage ⚙️\r\n\r\nOnce the server is up and running, you can interact with it via the frontend:\r\n\r\n1. **Start Attack**:\r\n   - Set up the attack parameters: target URL, attack method (HTTP Flood, Slowloris, TCP, etc...), packet size, duration, and delay.\r\n   - Press \"Start Attack\" to initiate the stress test.\r\n\r\n2. **Stop Attack**:\r\n   - Press \"Stop Attack\" to terminate the ongoing attack.\r\n\r\n### Example Request\r\n\r\n```json\r\n{\r\n  \"target\": \"http://example.com\",\r\n  \"attackMethod\": \"http_flood\",\r\n  \"packetSize\": 512,\r\n  \"duration\": 60,\r\n  \"packetDelay\": 500\r\n}\r\n```\r\n\r\n## Adding Proxies and User-Agents\r\n\r\nAccess to the ``data/proxies.txt`` and ``data/uas.txt`` can now be done fully in the frontend. Click the text button to the right of the beam button to open up the editor.\r\n\r\n![AnnotatedImage](docs/annotated-button.png)\r\n\r\n## Worker-Based Attack Handling 🔧💡\r\n\r\nEach attack type is handled in a separate worker thread, ensuring that the main server remains responsive. The attack workers are dynamically loaded based on the selected attack method (HTTP, etc...).\r\n\r\n## To-Do 📝\r\n\r\n- Add more attack methods:\r\n  - UDP 🌐\r\n  - DNS 📡\r\n  - And more! 🔥\r\n\r\n- Enhance attack statistics and reporting for better real-time monitoring. 📊\r\n\r\n## Contributing 💖\r\n\r\nFeel free to fork the repo and open pull requests with new attack protocols, bug fixes, or improvements. If you have an idea for a new feature, please share it! 😄\r\n\r\n### Adding New Attack Methods ⚡\r\n\r\nTo extend the server with new attack methods (e.g., Minecraft, TCP, UDP, DNS), you can create new worker files and add them to the server configuration.\r\n\r\nFor example:\r\n\r\n- Add a new attack method in the frontend settings.\r\n- Create the corresponding worker file (e.g., `minecraftAttack.js`).\r\n- Update the attack handler configuration to include the new method.\r\n\r\n```javascript\r\nconst attackHandlers = {\r\n  http_flood: \"./workers/httpFloodAttack.js\",\r\n  http_slowloris: \"./workers/httpSlowlorisAttack.js\",\r\n  tcp_flood: \"./workers/tcpFloodAttack.js\",\r\n  minecraft_ping: \"./workers/minecraftPingAttack.js\",\r\n\r\n  // Add more protocols as needed!\r\n  your_protocol: \"./workers/yourProtocolAttack.js\"\r\n};\r\n```\r\n\r\n---\r\n\r\n### FAQs ❓\r\n\r\n**1. What operating system does MMB support?**\r\n\r\n\u003e **Windows**, **Linux**, **Mac** and **Android (untested)**\r\n\r\n**2. It crashes on startup, giving a \"concurrently\" error**\r\n\r\n\u003e Try running two terminals instead of one, in the first one use \"npm run dev:client\", and in the other one \"npm run dev:server\". (This happened to several people with Windows 11)\r\n\r\n**3. I go to \"\u003chttp://localhost:3000\u003e\" and nothing appears.**\r\n\r\n\u003e Port `3000` is the server port, to see the UI you must use port `5173` (\u003chttp://localhost:5173\u003e)\r\n\r\n**4. Requests fail to be sent to the target server (Read timeout and variations)**\r\n\r\n\u003e You must put the corresponding proxies in the file `data/proxies.txt`. On each line, put a different proxy that will be used to perform the attack. The format must be the following:\r\n\u003e\r\n\u003e - `protocol://user:password@host:port` (Proxy with authentication)\r\n\u003e - `protocol://host:port`\r\n\u003e - `host:port` (Uses http as default protocol)\r\n\u003e - `host` (Uses 8080 as default port)\r\n\r\n---\r\n\r\n## License 📝\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n---\r\n\r\n## Disclaimer 🚨\r\n\r\nPlease note that this project is for educational purposes only and should not be used for malicious purposes.\r\n\r\n---\r\n\r\n### (｡♥‿♥｡) Happy Hacking 💖🎶\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsammwyy%2FMikuMikuBeam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsammwyy%2FMikuMikuBeam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsammwyy%2FMikuMikuBeam/lists"}