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.2.1

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.2.1
File	Size	Uploaded
cdmclient-1.2.1.tar.gz	9.4 kB	May 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cdmclient 1.2.1
File	Interpreter	ABI	Platform	Reset
cdmclient-1.2.1-py3-none-any.whl 12.0 kB May 15, 2026	Python 3	none	any	Details

Total release size: 21.4 kB

Release files / cdmclient-1.2.1.tar.gz

Download URL	cdmclient-1.2.1.tar.gz
Size	9.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`a3fe331dd29240fe09beef5e93a6c8aa91c3dc8f35681d058f3fabc16010a855`
BLAKE2b-256 checksum How to use checksums	`6213526bcc9b3a17619af03a94f045a184477c84e34cffc965485c4fa976e44d`
Upload date	May 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","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.2.1-py3-none-any.whl

Download URL	cdmclient-1.2.1-py3-none-any.whl
Size	12.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`dc56764314a994827028a0423815a44756d8973fe7315b9d009f5b3eb70aff6e`
BLAKE2b-256 checksum How to use checksums	`0f2d3a30d47378a99313ed75e23dabd0acd8d5b78d54947cabc7b0f5115983a5`
Upload date	May 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","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}`