BTor
BTor is a single-file installer + manager for Tor service and Tor Browser, designed to simplify setup and management on Linux systems.
Install / Use
/learn @Shubham-Chy/BTorREADME
<p align="center"> <img src="https://img.shields.io/github/stars/linux-brat/btor?style=for-the-badge&logo=github&color=blue" alt="Stars"/> <img src="https://img.shields.io/github/forks/linux-brat/btor?style=for-the-badge&logo=github&color=blueviolet" alt="Forks"/> <img src="https://img.shields.io/github/issues/linux-brat/btor?style=for-the-badge&logo=github&color=red" alt="Issues"/> <img src="https://img.shields.io/github/license/linux-brat/btor?style=for-the-badge&color=success" alt="License"/> </p> <p align="center"> <img src="https://img.shields.io/badge/Made%20for-Linux-2ea44f?style=for-the-badge&logo=linux" alt="Linux"/> <img src="https://img.shields.io/badge/Made%20for-Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Windows"/> <img src="https://img.shields.io/badge/Shell-Bash-4EAA25?style=for-the-badge&logo=gnu-bash&logoColor=white" alt="Bash"/> <img src="https://img.shields.io/badge/Tor-Network-7D4698?style=for-the-badge&logo=tor-project&logoColor=white" alt="Tor"/> </p> <div align="center">
🚀 Quick Start
Choose your platform and follow the official instructions on the Releases pages:
<p align="center"> <a href="https://github.com/linux-brat/BTor/releases/tag/Linux"> <img src="https://img.shields.io/badge/Refer%20to%20Linux%20Release-2ea44f?style=for-the-badge&logo=linux&logoColor=white" alt="Linux Release"/> </a> </p>🔧 Usage
CLI Commands
btor # Launch interactive menu
btor start # Start Tor service
btor stop # Stop Tor service
btor restart # Restart Tor service
btor enable # Enable Tor at boot
btor disable # Disable Tor at boot
btor status [--full] # Show service status
btor update # Update BTor
btor uninstall # Uninstall BTor
⚙️ Environment Variables
| Variable | Default | Description |
|------------------------|------------------------|-----------------------------------|
| BTOR_SERVICE_NAME | tor.service | Override Tor systemd service name |
| BTOR_HOME | ~/.btor | Installation directory |
| BTOR_BIN_LINK | /usr/local/bin/btor | Symlink path for global access |
| BTOR_REPO_RAW | GitHub raw script URL | Where updates are fetched from |
| BTOR_TOR_BROWSER_DIR | ~/.local/tor-browser | Where Tor Browser is installed |
| BTOR_TB_URL | Official Tor tarball | Override download URL |
Example:
BTOR_SERVICE_NAME=tor@default.service btor start
📜 License
MIT License © 2025 linux-brat
