/storm

A Modern Deluge Interface

Primary LanguageTypeScriptMIT LicenseMIT

You probably have a whole media stack for managing your legitimate media files remotely.

Sometimes though, downloads can get stuck or you want to add something manually to your Torrent client. Deluge's WebUI whilst powerful is pretty much useless on mobile devices.

Introducing Storm

A slick remote interface for Deluge that fully supports mobile devices (including as a home-screen app)

 

Usage

docker run --name storm \
  --network deluge \
  -p 8221:8221 \
  -e DELUGE_RPC_HOSTNAME=deluge \
  -e DELUGE_RPC_USERNAME=username \
  -e DELUGE_RPC_PASSWORD=password \
  ghcr.io/relvacode/storm

The recommended way to run Storm is with a Docker image.

You'll need a Deluge container running with a valid auth configuration. Storm needs a way to contact the Deluge RPC daemon so it's best that you create a Docker network and attach the Storm container to that network.

Once that's setup you'll need to configure Deluge to allow remote RPC connections:

Open up core.conf in your Deluge configuration folder and set

"allow_remote": true

Then you can use the following environment variables to configure Storm

Environment Description
DELUGE_RPC_HOSTNAME The Deluge RPC hostname
DELUGE_RPC_PORT The Deluge RPC port
DELUGE_RPC_USERNAME The username from Deluge auth
DELUGE_RPC_PASSWORD The password from Deluge auth
DELUGE_RPC_VERSION v1 or v2 depending on your Deluge version
STORM_API_KEY Enable authentication for the Storm API
STORM_BASE_PATH Set the base URL path. Defaults to /
Security

By default, Storm does not authenticate requests made to the API. When serving Storm over the public internet you should ensure access to your Deluge daemon is properly secured.

Storm comes with a simple built-in authentication mechanism which can be enabled with the environment variable STORM_API_KEY or the command-line option --api-key.

Set this to a reasonably secure password. Any requests made to Storm must now provide the API key in the request.

You should also seriously consider the use of HTTPS over the internet, with services like LetsEncrypt it's relatively easy to get a valid SSL certificate for free.

Deluge Version

Deluge has a different interface between versions 1 and 2. You must set DELUGE_RPC_VERSION to either v1 or v2 based on the version you have installed. Storm defaults to v1.

Note that in version 2, different RPC users are not able to see torrents created by another user (#38). If you're using multiple Deluge clients (such as the vanilla Web UI, or Sonarr, etc) you should make sure they're all using the same Deluge RPC account to connect to Deluge.

Development

The application is split into two parts, the frontend Angular code and the backend Go API adapter.

The backend API is presented as an HTTP REST api which talks directly to the Deluge RPC daemon. It also has the frontend code embedded directly into the binary so the application can be distributed as a single binary.

To start a development environment you must first install the node modules

cd frontend
npm install

Then start the Angular build server in watch mode. This will output the frontend distributable into frontend/dist and watch for changes.

cd frontend
npm run build -- --watch --configuration=development

In a separate terminal you can now start the main Storm binary in development mode. In development mode, instead of serving the frontend from the binary embedded source it will instead serve directly from the filesystem.

go run github.com/relvacode/storm/cmd/storm --listen=127.0.0.1:8221 --dev-mode [OPTIONS...]