|
1 | | -# 📶 Internet Speed Test App |
| 1 | +# Internet Speed Test App 🌐⚡ |
2 | 2 |
|
3 | | -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)**. |
| 3 | +  |
4 | 4 |
|
5 | | ---- |
| 5 | +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. |
6 | 6 |
|
7 | | -## 📸 Screenshots |
| 7 | +## Table of Contents |
8 | 8 |
|
9 | | -### 🖥️ GUI Version |
10 | | - |
| 9 | +- [Features](#features) |
| 10 | +- [Installation](#installation) |
| 11 | +- [Usage](#usage) |
| 12 | +- [Technologies Used](#technologies-used) |
| 13 | +- [Contributing](#contributing) |
| 14 | +- [License](#license) |
| 15 | +- [Contact](#contact) |
11 | 16 |
|
| 17 | +## Features |
12 | 18 |
|
13 | | ---- |
| 19 | +The **Internet Speed Test App** includes the following features: |
14 | 20 |
|
15 | | -## 🚀 Features |
| 21 | +- **Download Speed**: Measure how fast data can be downloaded from the internet. |
| 22 | +- **Upload Speed**: Check how quickly data can be sent to the internet. |
| 23 | +- **Ping (Latency)**: Determine the response time of your internet connection. |
| 24 | +- **ISP Information**: Get details about your Internet Service Provider. |
| 25 | +- **External IP Address**: Find out your public IP address. |
| 26 | +- **Result Sharing**: Easily share your Speedtest.net results with a link. |
16 | 27 |
|
17 | | -- ✅ Download & Upload speed test |
18 | | -- ✅ Ping (latency) measurement |
19 | | -- ✅ Best server selection |
20 | | -- ✅ ISP and IP address detection |
21 | | -- ✅ CLI & GUI modes |
22 | | -- ✅ Shareable result link |
| 28 | +## Installation |
23 | 29 |
|
24 | | ---- |
25 | | - |
| 30 | +To install the **Internet Speed Test App**, follow these steps: |
26 | 31 |
|
| 32 | +1. **Download the latest release** from [here](https://github.com/LELIONTRIBAL0/InternetSpeedTestApp/releases). Make sure to choose the appropriate version for your operating system. |
| 33 | +2. **Extract the files** if necessary. |
| 34 | +3. **Run the application** by executing the main script in your terminal or command prompt. |
27 | 35 |
|
28 | | -## 📁 Folder Structure |
| 36 | +## Usage |
29 | 37 |
|
| 38 | +Once you have installed the app, you can start testing your internet speed. |
30 | 39 |
|
31 | | -InternetSpeedTestApp/ |
32 | | -├── speed_test_cli.py # CLI-based speed test script |
33 | | -├── speed_test_gui.py # GUI-based speed test using Tkinter |
34 | | -├── requirements.txt # Required Python libraries |
35 | | -└── README.md # This documentation file |
| 40 | +1. **Open the application**: Launch the app from your terminal or command prompt. |
| 41 | +2. **Select the test type**: Choose whether you want to measure download speed, upload speed, or ping. |
| 42 | +3. **View your results**: The app will display your internet performance metrics clearly. |
| 43 | +4. **Share your results**: Use the provided link to share your Speedtest.net results with friends or colleagues. |
36 | 44 |
|
37 | | -yaml |
38 | | -Copy |
39 | | -Edit |
| 45 | +For more details, refer to the [Releases](https://github.com/LELIONTRIBAL0/InternetSpeedTestApp/releases) section. |
40 | 46 |
|
41 | | ---- |
| 47 | +## Technologies Used |
42 | 48 |
|
43 | | -## 📦 Installation |
| 49 | +The **Internet Speed Test App** is built using the following technologies: |
44 | 50 |
|
45 | | -Install Python packages using pip: |
| 51 | +- **Python**: The primary programming language used for development. |
| 52 | +- **Requests**: A library for making HTTP requests to gather data. |
| 53 | +- **Socket**: Used for network connections and operations. |
| 54 | +- **Speedtest-cli**: A command-line interface for testing internet speed. |
| 55 | +- **Modular Design**: The app follows a modular design for easy updates and enhancements. |
46 | 56 |
|
| 57 | +## Contributing |
47 | 58 |
|
48 | | -pip install -r requirements.txt |
49 | | -python speed_test_cli.py |
50 | | -It will output: |
| 59 | +We welcome contributions to improve the **Internet Speed Test App**! If you want to contribute, please follow these steps: |
51 | 60 |
|
52 | | -Download Speed |
| 61 | +1. **Fork the repository**: Click the "Fork" button at the top right of this page. |
| 62 | +2. **Create a new branch**: Use a descriptive name for your branch. |
| 63 | +3. **Make your changes**: Implement your features or fixes. |
| 64 | +4. **Submit a pull request**: Describe your changes and why they are needed. |
53 | 65 |
|
54 | | -Upload Speed |
| 66 | +## License |
55 | 67 |
|
56 | | -Ping |
| 68 | +This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. |
57 | 69 |
|
58 | | -IP Address |
| 70 | +## Contact |
59 | 71 |
|
60 | | -ISP |
| 72 | +For questions or suggestions, feel free to reach out: |
61 | 73 |
|
62 | | -Speedtest result URL |
63 | | - |
64 | | -python speed_test_gui.py |
65 | | -```bash |
66 | | -📃 License |
67 | | -This project is licensed under the MIT License. You are free to use, modify, and distribute it. |
| 74 | +- **GitHub**: [LELIONTRIBAL0](https://github.com/LELIONTRIBAL0) |
| 75 | +- **Email**: [your_email@example.com](mailto:your_email@example.com) |
68 | 76 |
|
| 77 | +## Conclusion |
| 78 | + |
| 79 | +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! |
| 80 | + |
| 81 | +Feel free to explore, contribute, and enhance this open-source project! |
0 commit comments