Access your remote files directly from qBittorrent Web UI, just like in the desktop app.
Access your remote files directly from qBittorrent Web UI, just like in the desktop app.
Current version: v0.6.1
⚠️ The script is enabled on all pages by default. See section below if you want to change this ⚠️
⚠️ There's a bug in Windows 11 that keeps explorer.exe processes open even after closing their respective window, if you never restart your machine you may be filling your RAM inadvertently. This issue was fixed in the 24H2 update (see related issue) ⚠️
By leveraging protocol handlers, a File Explorer window can be opened directly to a specified network path.
After mapping your remote and local path in the script settings, Ladderr can create a
protocol link pointing to your local files (by using information that's already available
in the Web UI). When opening a file or folder (by using the Open destination folder,
Open or Open containing folder menu items or by double-clicking the file or folder
in the Content tab), the protocol is invoked and an inline Powershell script is executed
to parse and open the target path.
The files in this repo:
ladderr-open: and ladderr-select: for WindowsTo learn more about protocol handlers, you can read MS-URI-Handlers.
ladderr.reg (can be easily removed with uninstall-ladderr.reg).ladderr-handler.sh and install.sh (linux dir) and execute the installer (can be easily removed with uninstall.sh).We need to map your qBittorrent remote paths to your local paths.
This can be done by going to the Tools navbar menu and clicking Ladderr Options.
Each mapping pairs a remote path (a root folder you configured under
Default Save Path in Options\Downloads\Saving Management) with its local path
equivalent on your machine. When opening a file or folder, Ladderr translates the
torrent's save path using the first mapping whose remote path matches — so order
matters: put more specific paths above broader ones. Use + Add mapping to add rows
and the ↑/↓ buttons to set their priority. If no mapping matches, nothing is opened.
A single mapping is enough if all your downloads live under one root:
/data/distros/distros/D:\Add more mappings when your downloads are spread across multiple locations:
/data/downloads/distros → Z:\media\distros/data/downloads/centos → Y:\archive\centosLocal paths can also point at an NFS\SMB\Samba server, e.g.:
/downloads\\server_name_or_ip\very\long\path\downloadsFor the script to work, you'll need xdg-utils and desktop-file-utils,
which should be already installed with most popular DE.
The installer script copies the handler (ladder-handler.sh) and creates a
.desktop entry that registers the ladderr-open: and ladderr-select: schemes.
These files go to their respective dirs in the XDG data home folder (under
~/.local/share). You can remove them and revert the process with ./uninstall.sh.
The handler uses xdg-open to open files/folders and the freedesktop
org.freedesktop.FileManager1 D-Bus interface to open a folder with the file
preselected (if it's unavailable, it simply opens the containing folder).
Since everyone's Web UI will have a different URL, the script is active on all pages by default. There's a check to detect when the page is a qBittorrent Web UI but to be safe you should change this.
For Tapermonkey:
Dashboard.Edit button in the rightmost column.Settings tab (left side below the Ladderr logo).Original matches in the Includes/Excludes section.Add... below the User matches box.For Violentmonkey:
Dashboard (⚙️ icon).Edit button (</> icon).Settings tab.Keep original under @match rules.Alternatively, if your extension doesn't allow this, you can do it manually:
// @match https://*/ and // @match http://*/.// @match https://192.168.1.100:8080/ or // @match http://myserver.local/.Unfortunately, if done manually, you'll have to redo this with each update.
ladderr.reg if you had a version prior to v0.5.4Content tab).Open and Open containing folder in the Content tab.ladderr-open: and ladderr-select: to allow opening files directly.