1cb24a701b
* feat: add enum for JSON-RPC error codes * feat: new `tr_rpc_request_exec()` overload that accepts string * feat: add JSON-RPC parse error handling * feat: add logic for branching to JSON-RPC or legacy API * feat: error codes for existing errors strings * refactor: async handlers now take the done cb as parameter * feat: support non-batch JSON-RPC requests * feat: support batch JSON-RPC requests * refactor: move JSON-RPC error codes to header * test: new tests for JSON-RPC * refactor(webui): use jsonrpc api * docs: update docs for jsonrpc * fix: clang-tidy warning * perf: avoid copying callback in batch mode * code review: don't commit to dropping old RPC * chore: fix shadowed variable warnings
Transmission Web Client
A web interface is built into all Transmission flavors, enabling them to be controlled remotely.
Notes for Packagers
Building Without Node
Transmission includes a prebuilt webapp bundle in its releases. This is
done because it's not easy to install the bundling tools on all of the
platforms that Transmission supports. Debian can't use this prebuilt
bundle due to its (understandable) policies that require building from
source. Unfortunately, building with node run build is also problematic
because of some of package.json's devDependencies aren't available as
Debian packages.
Follow these steps to build the webapp from source on Debian without Node:
$ sudo apt install rsass perl esbuild
$ cd transmission/web/
$ rsass assets/css/transmission-app.scss > assets/css/transmission-app.css
$ perl -p -i -e 's/transmission-app.scss/transmission-app.css/' src/main.js
$ esbuild \
--allow-overwrite \
--bundle \
--legal-comments=external \
--loader:.png=dataurl \
--loader:.svg=dataurl \
--minify \
--outfile=public_html/transmission-app.js \
src/main.js
Notes for Developers
$ npm install
$ npm run dev
Navigate to localhost:9000 to run the app.
When you use npm run dev, the bundler will stay running in the
background and will rebuild transmission-app.js whenever you change
and save a source file. When it's done, you can reload the page in
your browser to see your changes in action.
Notes for Testers
Use this bookmarklet to anonymize your torrent names before submitting a screenshot:
javascript:void%20function(){const%20a=document.getElementsByClassName(%22torrent-name%22);for(const%20b%20of%20a)console.log(b),b.textContent=%22Lorem%20ipsum%20dolor%20sit%20amet.iso%22}();
You’ll typically have about 3 seconds before the next batch of RPC updates overwrite the text content of any currently-downloading files.