Skip to main content

A Python script that continuously monitors and logs your internet speed.

Project description

InternetSpeedLogger

Python Script for Testing the Speed of your Internet Connection

This Python script periodically tests the internet speed of your network and logs the results in a CSV file. It uses the speedtest-cli library to measure internet speed. You can control the frequency of testing and duration of the entire test run via the script's parameters.

Installation

Just install using pip:

pip install InternetSpeedLogger

Usage

If you installed InternetSpeedLogger with pip, you should be able to simply execute the script from anywhere:

InternetSpeedLogger

Type InternetSpeedLogger --help to get detailed execution information:

usage: InternetSpeedLogger [-h] [--version] [-i INTERVAL] [-d DURATION]
                           [-l LOG_FILE]

A Python script that continuously monitors and logs your internet
speed. It tests both download and upload speeds at regular intervals
and records the data in a CSV file for easy analysis and tracking.
Ideal for auditing your network performance or ISP reliability over
time.
            

options:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -i INTERVAL, --interval INTERVAL
                        Testing interval in seconds. Make sure that the
                        interval is not shorter than the time needed for
                        testing. (default: 60)
  -d DURATION, --duration DURATION
                        Duration of the entire test runs. The script will
                        automatically end after this duration. Set to <= 0 for
                        infinite. (default: 0)
  -l LOG_FILE, --log_file LOG_FILE
                        Filename for the log-file. NOTE: ".csv" will be
                        automatically appended to the filename!

Default location of the log-file:
    A .csv-file will be created, which will contain all logged information.
    Default Filename: "YYYY-MM-DD_HH:MM:SS_internet_speeds.csv"
    Default Location: typically "/home/<username>" on Linux
                      typically "C:\Users\<username>" on Windows
                      typically "/Users/<username>" on macOS

Contribution

We warmly welcome contributions to the InternetSpeedLogger project! Your ideas and work can make a real difference to its development.

There are many ways to contribute:

  • Bug Reports: If you encounter any issues with the script, please create a new issue in the GitHub repository. Be as detailed as possible, including steps to reproduce the bug, the Python version you're using, and any error messages you've received.
  • Feature Requests: Have a great idea for improving InternetSpeedLogger? We'd love to hear about it! You can propose new features by opening a new issue and using the Feature Request template.
  • Code Contributions: If you are keen to get hands-on and directly contribute to the InternetSpeedDataLogger codebase, we enthusiastically welcome your input. Your efforts can help to fix bugs, add features, improve efficiency, and generally make the tool more robust and user-friendly.
  • Documentation: A project is only as good as its documentation. If you can improve the readme, comment the code more thoroughly, or create better user guides, your contributions are welcome.

Remember, the best way to make successful contributions is to communicate! Feel free to ask questions and discuss your ideas in the issue tracker.

In your pull request, provide a clear and comprehensive explanation of your changes and their necessity. This will help us understand the purpose of your contribution and expedite the review process.

Thank you for your interest in improving InternetSpeedDataLogger! :heart:

License

This script is released under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

InternetSpeedLogger-1.1.1.tar.gz (5.4 kB view hashes)

Uploaded Source

Built Distribution

InternetSpeedLogger-1.1.1-py3-none-any.whl (6.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page