Braver-tz

A cross-platform Python script that automatically downloads the latest stable release of Brave Browser directly from GitHub Releases, without relying on brave.com.

This project is useful in environments where the official Brave website is blocked or inaccessible, but GitHub remains reachable.

---

✨ Features

• Fetches the latest stable Brave release from the official GitHub repository
• Automatically detects:
  • Operating system (macOS, Windows, Linux)
  • CPU architecture (x64, ARM64, etc.)
  • Linux distribution family (Debian-based, RHEL-based when possible)
• Selects the most appropriate installer:
  • .dmg / .pkg for macOS
  • .exe for Windows
  • .deb or .rpm for Linux
• Downloads the installer automatically
• Automatic SHA256 hash verification for download integrity
• Optional interactive installation step
• Uses only Python standard library (no external dependencies)

---

🚀 Usage

Download the script:

git clone https://github.com/maotora/braver-tz.git
cd braver-tz

Run to download only:

python3 braver.py

Download and install (you will be prompted):

python3 braver.py --install

Print the direct download URL only (useful for automation):

python3 braver.py --print-only

Specify a custom download directory:

python3 braver.py --dir /path/to/downloads

---

🔧 Requirements

• Python 3.8+
• Internet access to api.github.com
• Administrator privileges only if installing (platform-dependent)

No third-party Python packages are required.

---

🖥️ Platform Support Status

Platform	Status
macOS	✅ Tested
Windows	✅ Tested
Linux (Ubuntu)	✅ Tested
Linux (Other distros)	⚠️ Untested

Important:
This script has been tested on macOS, Windows, and Ubuntu.
Testing on other Linux distributions (Debian, Fedora, Arch, etc.) is encouraged.

Please open an issue if you encounter:

• Incorrect installer selection
• Architecture mismatches
• Installation failures
• Any unexpected behavior

---

🧠 How It Works

1. Detects the local system OS and CPU architecture
2. Queries the GitHub Releases API for:

   brave/brave-browser
   

3. Selects the latest stable release
4. Chooses the best-matching installer asset
5. Downloads the installer
6. Optionally runs the installer using native OS mechanisms

The script intentionally avoids:

• Beta releases
• Nightly releases
• Release candidates

---

🔐 GitHub API Rate Limits

GitHub enforces unauthenticated rate limits.

If you hit a rate limit, set a token:

export GITHUB_TOKEN=your_token_here
python3 braver.py

---

🤝 Contributing

Contributions are welcome!

Especially needed:

• Linux distro compatibility testing

Please:

1. Open an issue describing the problem
2. Include OS, architecture, and installer name
3. Attach logs or error output when possible

---

📄 License

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