Skip to content

A Python/Kivy application that provides a graphical user interface for the tracert (Windows) or traceroute (macOS/Linux) commands.

Notifications You must be signed in to change notification settings

AliAlmasi/tracert-kivy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Tracert UI - Network Path Tracer

A Python/Kivy application that provides a graphical user interface for the tracert (Windows) or traceroute (macOS/Linux) commands.

Features

  • Cross-platform: Works on Windows, macOS, and Linux
  • Easy-to-use UI: Simple and intuitive interface built with Kivy
  • Real-time Results: View trace results in a scrollable text area
  • Status Updates: See current operation status in real-time
  • Clear Results: Clear previous results with a single click
  • Error Handling: Comprehensive error handling and timeout protection

Requirements

  • Python 3.7+
  • Kivy 2.3.0

Installation

  1. Clone or navigate to the project directory:
cd tracert-kivy
  1. Install dependencies:
pip install -r requirements.txt

Usage

Run the application:

python main.py
  1. Enter a hostname or IP address in the "Target Host" field
  2. Click "Start Trace" to begin the trace
  3. Wait for the results to appear in the results area
  4. Click "Clear Results" to reset the interface

How it Works

  • Windows: Uses the built-in tracert command
  • macOS/Linux: Uses the traceroute command
  • Threading: Network operations run in background threads to keep the UI responsive
  • Timeout: Traces will timeout after 60 seconds to prevent hanging

Troubleshooting

Command not found error

  • On Windows, ensure tracert is available (it's built-in)
  • On macOS/Linux, ensure traceroute is installed:
    • macOS: brew install traceroute
    • Linux: sudo apt-get install traceroute (Debian/Ubuntu)

Permission issues

  • Some systems require administrator/root privileges for traceroute
  • Run the application with elevated privileges if needed

UI doesn't respond

  • The application uses threading, so the UI should remain responsive
  • Traces timeout after 60 seconds if they take too long

Notes

  • The application automatically detects your operating system and uses the appropriate command
  • Results are displayed with full output from the trace command
  • The UI is designed to be mobile-friendly and works on tablets

About

A Python/Kivy application that provides a graphical user interface for the tracert (Windows) or traceroute (macOS/Linux) commands.

Topics

Resources

Stars

Watchers

Forks