Skip to content

ifauzeee/Zee-Cut

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

18 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”Œ Zee-Cut

Advanced WiFi Network Device Controller

A powerful, modern desktop application for managing and controlling devices connected to your WiFi network. Throttle or normalize internet access for any device with a single click.

Features Python Windows License


πŸ“– Overview

Zee-Cut is a network management tool inspired by NetCut, built with Python and a modern dark-themed GUI. It allows you to scan your local WiFi network for connected devices and control their internet access using ARP-based traffic management.

Whether you need to limit bandwidth-hogging devices or manage network access on your own WiFi, Zee-Cut provides an intuitive, one-click solution.

⚠️ Legal Notice: This tool is designed exclusively for use on networks you own and administer. Unauthorized use on networks you do not own is illegal and unethical. The developers assume no liability for misuse.


✨ Features

Feature Description
πŸ” Network Scanning Multi-method device discovery (ARP table, ping sweep, Scapy ARP broadcast)
🚫 Device Throttling Slow down or completely block internet access for any device via ARP spoofing
βœ… One-Click Restore Instantly restore normal connectivity for throttled devices
πŸ“‹ Device Information View IP address, MAC address, and hostname for every connected device
πŸ›‘οΈ Auto-Elevation Automatically requests Administrator privileges on launch
🎨 Modern Dark UI Sleek, dark-themed interface built with CustomTkinter
πŸ“¦ Portable EXE Single-file executable β€” no installation required
πŸ”„ Safe Cleanup Automatically restores all devices when the application is closed

πŸ–ΌοΈ Screenshots

Zee-Cut GUI Main List View

Zee-Cut GUI Alternate List View


πŸš€ Getting Started

Prerequisites

Before using Zee-Cut, ensure you have the following installed:

  1. Python 3.10+ β€” Download Python
  2. Npcap (Required for network scanning)
    • Download Npcap
    • During installation, check βœ… "Install Npcap in WinPcap API-compatible mode"

Installation

# Clone the repository
git clone https://github.com/ifauzeee/Zee-Cut.git
cd Zee-Cut

# Install Python dependencies
pip install -r requirements.txt

Running the Application

Option 1: Run with Python

python main.py

Option 2: Use the run script

run.bat

Option 3: Use the pre-built executable

Download Zee-Cut.exe from the Releases page, then right-click β†’ Run as Administrator.

Note: Administrator privileges are required for ARP operations. The application will prompt for elevation automatically.

Running Tests

python -m unittest discover -s tests -v

πŸ“– Usage Guide

  1. Launch β€” Run the application as Administrator
  2. Select Interface β€” Choose your WiFi adapter from the dropdown menu
  3. Scan Network β€” Click πŸ” Scan Network to discover all connected devices
  4. Throttle β€” Click 🚫 Lag Device on any device card to throttle its connection
  5. Restore β€” Click βœ… Normalkan to restore a device, or βœ… Restore All for all devices
  6. Exit β€” Close the application; all devices are automatically restored

πŸ”§ How It Works

Zee-Cut uses ARP (Address Resolution Protocol) Spoofing to control network traffic:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Target    │◄────────►│   Zee-Cut    │◄────────►│   Gateway   β”‚
β”‚   Device    β”‚  Spoofed β”‚  (Your PC)   β”‚  Spoofed β”‚   Router    β”‚
β”‚             β”‚  ARP     β”‚              β”‚  ARP     β”‚             β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Throttle Mode

  • Sends spoofed ARP replies to the target device, claiming to be the gateway
  • Sends spoofed ARP replies to the gateway, claiming to be the target
  • Traffic is intercepted and disrupted, causing lag or disconnection

Restore Mode

  • Sends correct ARP replies with the real MAC addresses
  • Network tables are repaired and normal connectivity is restored

Multi-Method Scanning

Zee-Cut employs three scanning techniques for maximum device detection:

Method Description Reliability
ARP Table (arp -a) Reads Windows' existing ARP cache ⭐⭐⭐ Highest
Ping Sweep Pings all IPs (1-254) in parallel to populate ARP table ⭐⭐ High
Scapy ARP Scan Broadcasts ARP requests across the subnet ⭐⭐ High

πŸ—οΈ Building from Source

Build Portable Executable

# Option 1: Use the build script
build.bat

# Option 2: Manual build with PyInstaller
python -m PyInstaller \
    --noconfirm \
    --onefile \
    --windowed \
    --name "Zee-Cut" \
    --add-data "core;core" \
    --hidden-import "scapy" \
    --hidden-import "scapy.all" \
    --hidden-import "scapy.layers.l2" \
    --hidden-import "scapy.layers.inet" \
    --hidden-import "scapy.arch.windows" \
    --hidden-import "customtkinter" \
    --hidden-import "psutil" \
    --collect-all "customtkinter" \
    --collect-all "scapy" \
    main.py

The compiled executable will be located at dist/Zee-Cut.exe.


πŸ“ Project Structure

Zee-Cut/
β”œβ”€β”€ main.py                 # Application entry point with UAC elevation
β”œβ”€β”€ gui.py                  # Modern dark-themed GUI (CustomTkinter)
β”œβ”€β”€ core/
β”‚   β”œβ”€β”€ __init__.py
β”‚   └── network.py          # Network engine (scanning, ARP spoofing, device management)
β”œβ”€β”€ assets/                 # Icons and resources
β”œβ”€β”€ requirements.txt        # Python dependencies
β”œβ”€β”€ build.bat               # Build script for creating portable .exe
β”œβ”€β”€ run.bat                 # Quick-launch script with admin elevation
β”œβ”€β”€ LICENSE                 # MIT License
└── README.md               # This file

πŸ› οΈ Tech Stack

Component Technology
Language Python 3.10+
GUI Framework CustomTkinter
Networking Scapy β€” ARP scanning & spoofing
System Info psutil β€” Interface detection
Packaging PyInstaller β€” Single-file executable
Packet Capture Npcap β€” Windows packet capture driver

⚠️ Important Notes

  • Administrator privileges are mandatory β€” ARP operations require raw socket access
  • Npcap must be installed β€” Required by Scapy for packet capture on Windows
  • Windows only β€” This application is designed for Windows 10/11
  • Closing the app restores all devices β€” No permanent network disruption
  • Use responsibly β€” Only on networks you own and manage

🀝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'feat: add 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 file for details.


πŸ™ Acknowledgments

  • Scapy β€” Powerful packet manipulation library
  • CustomTkinter β€” Modern Tkinter UI framework
  • Npcap β€” Windows packet capture driver
  • Inspired by NetCut β€” The original network cutting tool

Built with ❀️ by ifauzeee

About

Advanced Windows WiFi device controller for scanning, selective throttling, safe-list protection, and diagnostics export.

Topics

Resources

License

Stars

Watchers

Forks

Packages