---

Overview

MirrorMate is an open-source command-line tool to easily switch between the fastest or preferred mirrors for popular package managers and system repositories. Whether you're in a country with slow access to global package registries or want to use trusted local mirrors, MirrorMate simplifies the process by dynamically configuring mirrors for:

• Python's PyPI
• Node.js NPM
• Docker registries
• Go module proxy
• Debian/Ubuntu APT repositories

Demo

---

Why MirrorMate?

• Fast & Reliable: Use mirrors closer to your location to speed up downloads.
• Unified Interface: Manage all your package mirrors from one tool.
• Easy to Extend: Add new mirrors by editing a simple list — no coding required.
• Backup & Restore: Automatically backs up your current settings and allows quick restoration.
• Interactive & User-friendly: Uses a text menu interface (whiptail) for easy navigation.

---

Use Cases

• Developers in regions with restricted or slow access to official package registries.
• Teams that want to standardize their mirror configuration across environments.
• Anyone wanting to quickly test different mirrors for speed or availability.
• System administrators managing multiple machines and want consistent mirror setups.

---

Mirrors

#	Language	Mirror Name
1	Python	PyPI - Runflare (Iran)
2	Python	PyPI - Tsinghua (China)
3	Python	PyPI - Aliyun (China)
4	Python	PyPI - IranRepo (IR ICT) (Iran)
5	Python	PyPI - Mecan (AhmadRafiee) (Iran)
6	Python	PyPI - USTC (China)
7	Python	PyPI - Fastly (Global)
8	Node.js	NPM - RunFlare (Iran)
9	Node.js	NPM - Tsinghua (China)
10	Node.js	NPM - Aliyun (China)
11	Node.js	NPM - IranRepo (IR ICT) (Iran)
12	Node.js	NPM - Yarnpkg (Global)
13	Docker	Docker Hub - Runflare (Iran)
14	Docker	Docker Hub - ArvanCloud (Iran)
14	Docker	Docker Hub - Focker (Iran)
15	Docker	Docker Hub - Hamravesh (Iran)
16	Docker	Docker Hub - IranServer (Iran)
17	Docker	Docker Hub - USTC (China)
18	Docker	Docker Hub - MobinHost (Iran)
19	Docker	Docker Hub - Docker Official (Global)
20	Go	GoProxy - Aliyun (China)
21	Go	GoProxy - Golang Official (Global)
22	APT	Ubuntu 24.04 - ArvanCloud (Iran)
23	APT	Ubuntu 24.04 - Tsinghua (China)
24	APT	Ubuntu 24.04 - MobinHost (Iran)
25	APT	Ubuntu 22.04 - IranRepo (IR ICT) (Iran)
26	APT	Ubuntu 22.04 - Official (Global)

Installation

From apt repositories

sudo apt-get install mirrormate # not implemented yet

Using Curl (Recommended)

Because MirrorMate requires an interactive terminal, running it directly with curl | bash can cause display issues. Recommended: Download and run manually:

curl -sSL https://github.com/free-programmers/MirrorMate/raw/main/script.sh -o mirrormate.sh && chmod +x mirrormate.sh && sudo ./mirrormate.sh

Manually from git repo

# Clone repository
git clone https://github.com/free-programmers/MirrorMate.git
cd MirrorMate

# Make executable
chmod +x script.sh

# Run script with sudo
sudo ./script.sh

Requires:

• Bash shell
• whiptail installed (the script will try to install it if missing)
• sudo privileges

---

Usage

Run the script and follow the menu prompts:

1. Select a category (Python, Node.js, Docker, Go, APT)
2. Choose your preferred mirror from the list
3. Confirm to apply the mirror
4. Optionally restore previous settings anytime from the menu

---

Adding New Mirrors

To add a new mirror, simply edit the MIRRORS array in the script:

MIRRORS+=(
    "Python|PyPI - New Mirror Name|https://new.mirror.url/simple"
    "APT|Ubuntu 22.04 - New Mirror|deb https://new.mirror.url/ubuntu/ jammy main restricted universe multiverse"
)

Each mirror entry has the format:

Category|Display Name|Mirror URL or source list content

---

Contributing

Contributions are welcome! Here's how you can help:

• Add new mirrors: Submit mirror URLs for your region or provider.
• Fix bugs: Report or fix issues on GitHub.
• Improve UI: Suggest or implement UI improvements or better UX.
• Enhance features: Add new package managers or mirror types.

To contribute:

1. Fork the repository
2. Create a new branch (git checkout -b feature-name)
3. Make your changes
4. Test thoroughly
5. Submit a pull request with a clear description

---

License

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

---

Contact & Support

For questions, feature requests, or issues, please open an issue on GitHub:
https://github.com/free-programmers/MirrorMate/issues