# qbittorrent-cli
This unofficial app installation guide is provided for your convenience. The guide is provided as-is and may not be updated or maintained by Ultra.cc. Unofficial support may be offered via Discord only and at the sole discretion of Ultra.cc staff. Use at your own risk and only proceed if you are comfortable managing the application on your own.
qbittorrent-cli is a feature rich CLI to manage [qBittorrent](https://docs.ultra.cc/books/qbittorrent/page/qbittorrent). It provides features such as; Add torrents, categories, tags, reannounce and import torrent sessions from other clients. - More information can be found [here](https://github.com/ludviglundgren/qbittorrent-cli). ## Installation - Go [here](https://github.com/ludviglundgren/qbittorrent-cli/releases) and find the latest binary filename that ends in `linux_amd64.tar.gz` and copy its URL. - For this guide, we will use this URL as an example: `https://github.com/ludviglundgren/qbittorrent-cli/releases/download/v2.0.0/qbittorrent-cli_2.0.0_linux_amd64.tar.gz` - Connect to your Ultra.cc service via [SSH](https://docs.ultra.cc/books/secure-shell-%28ssh%29/page/how-to-connect-to-your-ultracc-slot-via-ssh) - Execute the following command (changing the URL to the one copied from GitHub): ```sh curl -LO https://github.com/ludviglundgren/qbittorrent-cli/releases/download/v2.0.0/qbittorrent-cli_2.0.0_linux_amd64.tar.gz ``` - Next, we will extract the binary. - The filename may be different if you have downloaded a newer version. ```sh tar -xzvf qbittorrent-cli_2.0.0_linux_amd64.tar.gz ``` - Next, we will move the binary into `$PATH`, allowing it to be globally executable. And also remove some unnecessary files left from the installation. ```sh mv qbt ~/bin/ && rm -v qbittorrent-cli_2.0.0_linux_amd64.tar.gz LICENSE README.md ``` - Verify it has been installed by executing: ```sh qbt ``` - Next, we need to create a bare minimum configuration file. To do so, execute the following command: ```sh mkdir -p ~/.config/qbt && touch ~/.config/qbt/.qbt.toml ``` - Open the configuration file with the nano editor by executing the following command: ```sh nano ~/.config/qbt/.qbt.toml ``` - Paste the below text into the configuration file. ```toml [qbittorrent] addr = "http://127.0.0.1:Before you start migrating your torrent session. Make sure you have set the same default save path for your destination torrent client, as you have set for your source torrent client. Failing to do so would result in your new torrent client re-downloading all of your torrents again.
- Import torrent session to qBittorrent ```sh qbt torrent import deluge --source-dir ~/.config/deluge/state/ --qbit-dir ~/.local/share/qBittorrent/BT_backup/ ``` - Export torrent session from qBittorrent ```sh qbt torrent export --source ~/.local/share/qBittorrent/BT_backup/ --export-dir ~/watch/deluge ``` - In the above command, we have used Deluge as an example. The paths can easily be replaced to match the path of other torrent clients. See them listed below.