Channel Surfer is a Python script that allows you to manage multiple Kismet endpoints and control Wi-Fi adapters connected to those endpoints. It provides an interactive command-line interface for adding, removing, and interacting with Kismet endpoints.
- Manage multiple Kismet endpoints
- Add and remove endpoints dynamically
- Lock Wi-Fi adapters to specific channels
- Set Wi-Fi adapters to various hopping modes
- Supports 2.4GHz, 5GHz, and dual-band hopping
- Persistent storage of endpoint configurations
Run the script using Python:
python3 channel_surfer.py
- Select an endpoint: Choose an existing endpoint to interact with.
- Add a new endpoint: Add a new Kismet endpoint to the configuration.
- Remove an endpoint: Remove an existing endpoint from the configuration.
- Exit: Quit the application.
After selecting an endpoint, you can perform the following actions:
- Lock channel for a device: Set a Wi-Fi adapter to a specific channel.
- Set device to hopping mode: Configure a Wi-Fi adapter to hop between channels.
- 2.4GHz
- 5GHz
- Both 2.4GHz and 5GHz
- Set device to hop between two channels: Configure a Wi-Fi adapter to hop between two specific channels.
- Back to endpoint selection: Return to the endpoint selection menu.
The script stores endpoint configurations in a JSON file named endpoints.json
in the .channel_surfer
directory within the user's home folder. This file is automatically created and updated as you add or remove endpoints. The configuration file location is consistent regardless of where you run the script from.
- Ensure that you have the necessary permissions to interact with the Kismet API on the specified endpoints.
- The script uses ANSI color codes for a more user-friendly interface. Make sure your terminal supports ANSI colors for the best experience.