mircheck 1.1.0

A tool to find the fastest mirror for Ubuntu and its derivatives

Mircheck - Fastest Mirror Selector for Ubuntu and it's derivatives

This script helps you find the fastest mirror for your Ubuntu and it's derivatives and generates a sources.list file accordingly. It downloads the Release file from each mirror to measure the speed and identifies the fastest one.

Requirements

• Python 3.6 or higher
• requests library

Installation

1. Recommended - Using PIP

   pip install mircheck
   

2. Clone the repository:

   git clone https://github.com/arkrwn/mircheck.git
   cd mircheck/mircheck
   pip install -r ../requirements.txt
   chmod +x main.py
   

Usage

Install using pip: `mircheck [options] <distribution> <country>`
Install using git: `./mircheck [options] <distribution> <country>`

Positional Arguments

• distribution: Distribution code name (e.g., jammy, bionic).
• country: Country code or name.

Options

• -a, --arch ARCH: Specify architecture (e.g., amd64, arm64). Default is the architecture of the current machine.
• -s, --sources: Include deb-src lines in the generated sources.list.
• -o, --outfile OUTFILE: Output file for sources.list. Default is ./sources.list.
• -n, --nonfree: Include non-free section in the generated sources.list.
• -d, --distribution_type {stable, testing, unstable, experimental, release_codename, sid}: Specify which distribution of Debian to use. Default is stable.

Examples

1. Find the fastest mirror for Ubuntu jammy in Indonesia and save to the current directory:

   mircheck jammy id
   

2. Find the fastest mirror for Debian stable in Germany and include source lines:

   mircheck stable germany -s
   

3. Find the fastest mirror for Ubuntu bionic in the USA and save to a custom path:

   mircheck bionic us -o /path/to/custom/sources.list
   

Output

The script will test each mirror's speed and display the results in kilobytes per second (KB/s). It will identify the fastest mirror and generate a sources.list file with the appropriate entries.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Feel free to submit issues and pull requests. For major changes, please open an issue first to discuss what you would like to change.

Acknowledgements

• The Ubuntu for providing mirror lists.