CDMClient

CDM - Centralized Download Manager Client CDMClient is the client application for the CDM Server.

This client communicates with the CDM Server to periodically send the download status from Transmission/QBittorrent and check for new torrent files to download. If new torrents are available, they are downloaded and added to Transmission/QBittorrent client.

Installation

Install or Upgrade the Package

Run the following command to install or upgrade CDMClient:

python3 -m pip install --upgrade CDMClient --user

Create a Systemd Service

To set up CDMClient as a systemd service, execute the following commands:

Create the service file:

echo "[Unit]
Description=cdm-client service
After=multi-user.target
Conflicts=getty@tty1.service

[Service]
User=${USER}
Type=simple
Environment=LC_ALL=C.UTF-8
Environment=LANG=C.UTF-8
ExecStart=${HOME}/.local/bin/cdm-client
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target" | sudo tee /etc/systemd/system/cdm-client.service

Reload systemd and enable the service:

sudo systemctl daemon-reload
sudo systemctl enable cdm-client.service
sudo systemctl start cdm-client.service

Add automatic update (optional)

To keep CDMClient updated automatically, you can add a cron job. Run:

crontab -e

Then add the following line to the crontab file:

0 3 * * * /usr/bin/python3 -m pip install --upgrade CDMClient --user && systemctl restart cdm-client.service

Configuration

The configuration file is located at: ~/.config/cdm_client/config.ini

This file is automatically generated when the service starts. Below is an example configuration:

[connection]
server_host = "https://cdmserver.com"
api_key = "1409d6ed79280aadcbe20f8f21981e89"
client_host =
client_port =
client_username =
client_password =
client_type= transmission # possible values: transmission or qbitorrent

Configuration Details:

server_host: The full URL of the CDM Server (e.g., https://cdmserver.com).
api_key: The API key generated when adding a new device on the CDM Server's devices page. Refer to the Devices Page Documentation.
client_username and client_password: Required authentication for the selected torrent client.
client_type: Specify either transmission or qbitorrent, depending on the torrent client you are using.
client_host and client_port: Optional. If not specified, defaults to localhost and the default port for the selected client type.

Viewing Logs

To monitor the service logs, use the following command:

journalctl -fu cdm-client

Metadata

Release files for cdmclient 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cdmclient 1.1.0
File	Size	Uploaded
cdmclient-1.1.0.tar.gz	9.4 kB	Apr 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cdmclient 1.1.0
File	Interpreter	ABI	Platform	Reset
cdmclient-1.1.0-py3-none-any.whl 11.9 kB Apr 12, 2026	Python 3	none	any	Details

Total release size: 21.3 kB

Release files / cdmclient-1.1.0.tar.gz

Download URL	cdmclient-1.1.0.tar.gz
Size	9.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`ce32b03f90c8ed16817953576f1b00265f7857d1f9f19d5c20bc4458de47f9a0`
BLAKE2b-256 checksum How to use checksums	`64fcc7b823c7df9cac4ed7fa69498a8d8636d69eb6c5a33df6d6f1ffb0978962`
Upload date	Apr 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / cdmclient-1.1.0-py3-none-any.whl

Download URL	cdmclient-1.1.0-py3-none-any.whl
Size	11.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`188e0d16eeec6ada41bd845b5218e0ff895274d913aac0757a9e6c6875204a90`
BLAKE2b-256 checksum How to use checksums	`e230698a4332b5cb6a30693f8552da807459ad10a4bae209c731ffd8bad5222b`
Upload date	Apr 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`