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.0.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.0.1
File	Size	Uploaded
cdmclient-1.0.1.tar.gz	8.8 kB	Oct 19, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for cdmclient 1.0.1
File	Interpreter	ABI	Platform	Reset
cdmclient-1.0.1-py3-none-any.whl 11.3 kB Oct 19, 2025	Python 3	none	any	Details

Total release size: 20.1 kB

Release files / cdmclient-1.0.1.tar.gz

Download URL	cdmclient-1.0.1.tar.gz
Size	8.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`0ad44c0e2c49ed9befbab86ce842adab4b0af9285ef5ea2bb402a8aff6230d22`
BLAKE2b-256 checksum How to use checksums	`6529cf4092f2dc9cee7c7de165aac132e6526ca2fb81fb6ef3335ce6fba2bfe3`
Upload date	Oct 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.4`

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

Download URL	cdmclient-1.0.1-py3-none-any.whl
Size	11.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`66f1aa4e0bd9f1577d96cded9f63a85db988da3687aadba90d90ec68fc4ca00d`
BLAKE2b-256 checksum How to use checksums	`b61cb9bdbb7dde8f7b4d1a3e98042169523d13582a812c05aaf9e141988597d2`
Upload date	Oct 19, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.4`