bt2qbt/README.md

bt2qbt

bt2qbt is cli tool for export from uTorrent\Bittorrent into qBittorrent (convert)

Important

Actual version tested with uTorrent 3.5.5 (build 46206) and qBittorrent 4.4.2. It should work with older version utorrent and newer version of qBittorrent, but it isn't tested.

Important

In most cases just enough run app. For Windows users double-click on downloaded exe file. But read notices and warnings below

Important

For new qBittorrent 5.X+ check that it use fastresume files before you migrate. Preferences -> Advanced -> Resume data storage type -> Fastresume files

• bt2qbt
  • Feature
  • Help
  • Usage examples

Feature:

• Processing all torrents
• Processing torrents with subdirectories and without subdirectories
• Processing torrents with renamed files
• Processing torrents with non-standard encodings (for example, cp1251)
• Processing of torrents in the not ready state *
• Processing magnet links
• Processing modified torrent names
• Save date, metrics, status. **
• Import of tags and labels
• Multithreading
• Covered with tests

Note

* This torrents will not be done (0%) and will need force recheck (right click on torrent -> Force recheck)

[!NOTE] * If you migrate from windows to linux and use replace function attention that multiple flags -r processing one by one

Note

* If you migrate from windows -> to linux

• If your torrent files are saved to some other place, you must use the flag: --search ... with actual paths in yours system
• You may need to define path separathor with --sep flag

Note

** The calculation of the completed parts is based only on the priority of the files in torrent. Don't transfer global uTorrent/BitTorrent statistics.

Note

*** Partially downloaded torrents will be visible as 100% completed, but in fact you will need to do a recheck (right click on torrent -> Force recheck). Without recheck torrents not will be valid. This is due to the fact that conversion of .dat files in which parts of objects are stored is not implemented.

Important

Before using bt2qbt, do not forget to make backup from:

• bittorrent\utorrent data,
• qbittorrent folder, and
• config %APPDATA%/Roaming/qBittorrent/qBittorrent.ini. Close both programs before making a copy!

Important

You must previously disable option: "Append .!ut/.!bt to incomplete files" in preferences of uTorrent/Bittorrent, or that files wouldn't be handled

Help:

Help (from cmd or powershell)

Usage:
  bt2qbt_v1.99_amd64.exe [OPTIONS]

Application Options:
  -s, --source=         Source directory that contains resume.dat and torrents files (default:
                        C:\Users\rumanzo\AppData\Roaming\uTorrent)
  -d, --destination=    Destination directory BT_backup (as default) (default:
                        C:\Users\rumanzo\AppData\Local\qBittorrent\BT_backup)
  -c, --categories=     Path to qBittorrent categories.json file (for write tags) (default:
                        C:\Users\rumanzo\AppData\Roaming\qBittorrent\categories.json)
      --without-labels  Do not export/import labels
      --without-tags    Do not export/import tags
  -t, --search=         Additional search path for torrents files
                        Example: --search='/mnt/olddisk/savedtorrents' --search='/mnt/olddisk/workstorrents'
  -r, --replace=        Replace save paths. Important: you have to use single slashes in paths
                        Delimiter for from/to is comma - ,
                        Example: -r "D:/films,/home/user/films" -r "D:/music,/home/user/music"

      --sep=            Default path separator that will use in all paths. You may need use this flag if you migrating
                        from windows to linux in some cases (default: \)
  -v, --version         Show version

Usage examples:

• If you just run the application with no options specified, it will convert torrents:
  • from: %APPDATA%\uTorrent\
  • to: %LOCALAPPDATA%\qBittorrent\BT_BACKUP\

C:\Users\user\Downloads> .\bt2qbt.exe
It will be performed processing from directory C:\Users\user\AppData\Roaming\uTorrent\ to directory C:\Users\user\AppData\Local\qBittorrent\BT_backup\
Check that the qBittorrent is turned off and the directory C:\Users\user\AppData\Local\qBittorrent\BT_backup\ and config C:\Users\user\AppData\Roaming\qBittorrent\qBittorrent.ini is backed up.
Check that you previously disable option "Append .!ut/.!bt to incomplete files" in preferences of uTorrent/Bittorrent 


Press Enter to start

Started
1/2 Sucessfully imported 1.torrent
2/2 Sucessfully imported 2.torrent

Press Enter to exit

• Run application from cmd or powershell with keys, if you want change source dir or destination dir, or export/import behavior

C:\Users\user\Downloads> .\bt2qbt.exe -s C:\Users\user\AppData\Roaming\BitTorrent\
It will be performed processing from directory C:\Users\user\AppData\Roaming\BitTorrent\ to directory C:\Users\user\AppData\Local\qBittorrent\BT_backup\
Check that the qBittorrent is turned off and the directory C:\Users\user\AppData\Local\qBittorrent\BT_backup\ is backed up.
Check that you previously disable option "Append .!ut/.!bt to incomplete files" in preferences of uTorrent/Bittorrent 


Press Enter to start
Started
1/3233 Sucessfully imported 1.torrent
2/3233 Sucessfully imported 2.torrent
3/3233 Sucessfully imported 3.torrent
...
3231/3233 Sucessfully imported 3231.torrent
3232/3233 Sucessfully imported 3232.torrent
3233/3233 Sucessfully imported 3233.torrent

Press Enter to exit