History

Hendrik Luup 34b8c827a8 refactor(web): use crypto.randomUUID for UUID if available (#6649 ) crypto.randomUUID() is the most up to date way to generate UUIDs. It works in secure context (HTTPS) and for localhost. https://developer.mozilla.org/en-US/docs/Web/API/Crypto/randomUUID It has a wide browser support, but we are keeping the fallback for older browsers and for cases where users are using a custom hostname without HTTPS, that's not consider a secure context. https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts		2024-03-04 18:16:31 -06:00
..
assets	feat: widen progressbar and increase font size in compact mode	2024-01-06 15:54:52 -06:00
public_html	chore: webui scss cleanup (#6471 )	2024-01-01 17:22:18 -06:00
src	refactor(web): use crypto.randomUUID for UUID if available (#6649 )	2024-03-04 18:16:31 -06:00
.eslintrc.js	build: use esbuild to bundle the web app (#6280 )	2023-11-27 19:23:40 -06:00
.gitattributes	feat: web client style (#2609 )	2022-02-11 18:32:20 -06:00
.nvmrc	[Web] Magnet link, Main window toolbar accessibility, ARM build fix, Dependencies update (#2586 )	2022-02-09 10:28:48 -06:00
CMakeLists.txt	build: use esbuild to bundle the web app (#6280 )	2023-11-27 19:23:40 -06:00
README.md	fix: update WebUI build instructions to use `dataurl` loader for images (#6430 )	2023-12-24 07:53:57 -06:00
esbuild.mjs	fix: esbuild load `svg` and `png` as `dataurl` type (#6409 )	2023-12-23 10:32:38 -06:00
package-lock.json	build: use esbuild to bundle the web app (#6280 )	2023-11-27 19:23:40 -06:00
package.json	build: use esbuild to bundle the web app (#6280 )	2023-11-27 19:23:40 -06:00
package.json.buildonly	build: use esbuild to bundle the web app (#6280 )	2023-11-27 19:23:40 -06:00
prettier.config.js	feat: web client refresh (#1476 )	2020-10-23 20:04:25 -05:00
stylelint.config.js	build: bump web client dev-dependencies (#5789 )	2023-07-14 19:26:48 -05:00

README.md

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}();