Skip to content

Add CSV saving functionality for speed test results #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Add CSV saving functionality for speed test results #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1a05654
Update README.md
LELIONTRIBAL0 Nov 12, 2025
7eaad7b
Add CSV saving functionality for speed test results
enzomarx Nov 12, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 70 additions & 3 deletions InternetSpeedTestApp/speed_test_cli.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
import speedtest
import socket
import requests
import csv # <-- Added to handle the CSV file
import os # <-- Added to check if the file already exists
from datetime import datetime # <-- Added to the timestamp

def get_local_ip():
try:
Expand Down Expand Up @@ -40,21 +43,85 @@ def perform_speed_test():
"result_link": result_link
}

# --- NEW FEATURE ADDED ---
def save_results_csv(data_row):
"""
Saves a data row in a CSV file.
Creates the header if the file does not exist.
"""
FILENAME = 'speedtest_history.csv'

# Define the headers (columns) of our CSV
# They correspond to the keys of the 'data_to_save' dictionary in the main() function
HEADERS = ['timestamp', 'download', 'upload', 'ping', 'isp', 'external_ip', 'result_link']

# 'os.path.isfile' checks if the file already exists.
# We use this to know if we need to write the header.
file_exists = os.path.isfile(FILENAME)

try:
# 'a' means 'append'. This adds to the end of the file without deleting the content.
# 'newline=""' is important for the csv module to function correctly in Windows.
with open(FILENAME, 'a', newline='', encoding='utf-8') as f:

# DictWriter is great because it maps dictionaries to CSV rows.
# Using 'fieldnames=HEADERS' ensures the correct column order.
writer = csv.DictWriter(f, fieldnames=HEADERS)

# If the file did NOT exist, we write the header.
if not file_exists:
writer.writeheader()

# Write the data line (our dictionary)
writer.writerow(data_row)

print(f"✅ Results saved successfully in {FILENAME}")

except IOError as e:
print(f"❌ Error saving CSV file: {e}")
except Exception as e:
print(f"❌ An unexpected error occurred while saving: {e}")
# --- END OF NEW FUNCTION ---


def main():
print("🔍 Starting network details retrieval...\n")
local_ip = get_local_ip()
external_ip, isp, city, country = get_external_ip_and_isp()
print(f"📡 Local IP Address : {local_ip}")
print(f"🌐 External IP Address : {external_ip}")
print(f"🏢 ISP : {isp}")
print(f"📍 Location : {city}, {country}\n")
print(f"🏢 ISP : {isp}")
print(f"📍 Location : {city}, {country}\n")

results = perform_speed_test()

print("\n📊 Speed Test Results Summary:")
print(f"⬇️ Download Speed : {results['download']:.2f} Mbps")
print(f"⬆️ Upload Speed : {results['upload']:.2f} Mbps")
print(f"⏱ Ping : {results['ping']:.2f} ms")
print(f"\n🔗 Share your results with this link: {results['result_link']}")

# --- BLOCK ADDED TO SAVE ---
print("\n💾 Saving results to history...")

# 1. Obtain the current timestamp in ISO format (default).
current_timestamp = datetime.now().isoformat()

# 2. Consolidate all the data we want to save into a dictionary.
# The keys (e.g., 'timestamp') MUST MATCH the HEADERS of the save_results_csv function.
data_to_save = {
'timestamp': current_timestamp,
'download': results['download'], # We saved the "raw" (float) value for analysis.
'upload': results['upload'], # Same
'ping': results['ping'], # Same
'isp': isp,
'external_ip': external_ip,
'result_link': results['result_link']
}

# 3. Call the new function to save.
save_results_csv(data_to_save)
# --- END OF ADDED BLOCK ---

if __name__ == "__main__":
main()

97 changes: 55 additions & 42 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,68 +1,81 @@
# 📶 Internet Speed Test App
# Internet Speed Test App 🌐⚡

A simple and lightweight Internet Speed Test application written in **Python**. This tool allows you to test your internet speed via **Command Line Interface (CLI)** or a user-friendly **Graphical User Interface (GUI)**.
![GitHub release](https://img.shields.io/github/release/LELIONTRIBAL0/InternetSpeedTestApp.svg) ![License](https://img.shields.io/badge/license-MIT-blue.svg)

---
Welcome to the **Internet Speed Test App**! This application provides a quick, simple, and open-source way to check your internet performance. Unlike online browser-based tools, this app gives you direct access to vital metrics such as download and upload speeds, ping (latency), ISP and external IP address, and a link to share your Speedtest.net results.

## 📸 Screenshots
## Table of Contents

### 🖥️ GUI Version
![image](https://github.com/user-attachments/assets/ac39cf42-b6ba-4061-b2e9-c3994d4f3f89)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Technologies Used](#technologies-used)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)

## Features

---
The **Internet Speed Test App** includes the following features:

## 🚀 Features
- **Download Speed**: Measure how fast data can be downloaded from the internet.
- **Upload Speed**: Check how quickly data can be sent to the internet.
- **Ping (Latency)**: Determine the response time of your internet connection.
- **ISP Information**: Get details about your Internet Service Provider.
- **External IP Address**: Find out your public IP address.
- **Result Sharing**: Easily share your Speedtest.net results with a link.

- ✅ Download & Upload speed test
- ✅ Ping (latency) measurement
- ✅ Best server selection
- ✅ ISP and IP address detection
- ✅ CLI & GUI modes
- ✅ Shareable result link
## Installation

---
![Screenshot 2025-05-15 112841](https://github.com/user-attachments/assets/1c1fd4fd-507a-42c5-b413-cd34734e36b3)
To install the **Internet Speed Test App**, follow these steps:

1. **Download the latest release** from [here](https://github.com/LELIONTRIBAL0/InternetSpeedTestApp/releases). Make sure to choose the appropriate version for your operating system.
2. **Extract the files** if necessary.
3. **Run the application** by executing the main script in your terminal or command prompt.

## 📁 Folder Structure
## Usage

Once you have installed the app, you can start testing your internet speed.

InternetSpeedTestApp/
├── speed_test_cli.py # CLI-based speed test script
├── speed_test_gui.py # GUI-based speed test using Tkinter
├── requirements.txt # Required Python libraries
└── README.md # This documentation file
1. **Open the application**: Launch the app from your terminal or command prompt.
2. **Select the test type**: Choose whether you want to measure download speed, upload speed, or ping.
3. **View your results**: The app will display your internet performance metrics clearly.
4. **Share your results**: Use the provided link to share your Speedtest.net results with friends or colleagues.

yaml
Copy
Edit
For more details, refer to the [Releases](https://github.com/LELIONTRIBAL0/InternetSpeedTestApp/releases) section.

---
## Technologies Used

## 📦 Installation
The **Internet Speed Test App** is built using the following technologies:

Install Python packages using pip:
- **Python**: The primary programming language used for development.
- **Requests**: A library for making HTTP requests to gather data.
- **Socket**: Used for network connections and operations.
- **Speedtest-cli**: A command-line interface for testing internet speed.
- **Modular Design**: The app follows a modular design for easy updates and enhancements.

## Contributing

pip install -r requirements.txt
python speed_test_cli.py
It will output:
We welcome contributions to improve the **Internet Speed Test App**! If you want to contribute, please follow these steps:

Download Speed
1. **Fork the repository**: Click the "Fork" button at the top right of this page.
2. **Create a new branch**: Use a descriptive name for your branch.
3. **Make your changes**: Implement your features or fixes.
4. **Submit a pull request**: Describe your changes and why they are needed.

Upload Speed
## License

Ping
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

IP Address
## Contact

ISP
For questions or suggestions, feel free to reach out:

Speedtest result URL
![image](https://github.com/user-attachments/assets/ac39cf42-b6ba-4061-b2e9-c3994d4f3f89)
python speed_test_gui.py
```bash
📃 License
This project is licensed under the MIT License. You are free to use, modify, and distribute it.
- **GitHub**: [LELIONTRIBAL0](https://github.com/LELIONTRIBAL0)
- **Email**: [your_email@example.com](mailto:your_email@example.com)

## Conclusion

The **Internet Speed Test App** offers a straightforward way to measure your internet performance. With its easy-to-use interface and essential features, it stands out as a reliable tool for anyone looking to assess their connection speed. Download the latest version from the [Releases](https://github.com/LELIONTRIBAL0/InternetSpeedTestApp/releases) section and start testing today!

Feel free to explore, contribute, and enhance this open-source project!