go-transmission-stats/README.md

go-transmission-stats

Get stats from a remote Transmission instance using the Transmission RPC API, and output the stats into a HTML document using Go's html/template library.

For other people using this, change the stylesheet in template.html to your preferred one. Also edit the following for your remote Transmission instance:

export RPC_HOST="<ip address of Transmission server>"
export RPC_USER="<rpc username>"
export RPC_PASSWORD="<rpc password>"
export HTML_FILE="/path/to/html/output/file.html"
export GMI_FILE="/path/to/gemini/output/file.gmi"

My personal use case for this involves running the Go binary go-transmission-stats on a systemd timer that triggers the corresponding service every 12 hours.

First build the binary:

git clone https://codeberg.org/hyperreal/go-transmission-stats
cd go-transmission-stats
go build

Move the binary to a location in PATH:

sudo mv go-transmission-stats /usr/local/bin/

Create the systemd service:

[Unit]
Description=go-transmission-stats service

[Service]
Type=oneshot
ExecStart=/usr/local/bin/go-transmission-stats
User=<your user>
Group=<your user's group>
WorkingDirectory=/home/user/go-transmission-stats
Environment="RPC_HOST=<ip address of Transmission server>"
Environment="RPC_USER=<rpc username>"
Environment="RPC_PASSWORD=<rpc password>"
Environment="HTML_FILE=/path/to/html/output/file.html"
Environment="GMI_FILE=/path/to/gemini/output/file.gmi"

Create the systemd timer:

[Unit]
Description=go-transmission-stats timer

[Timer]
OnCalendar=00/12:00

[Install]
WantedBy=default.target

Move the files to systemd directory and enable the systemd timer:

sudo mv go-transmission-stats.service go-transmission-stats.timer /etc/systemd/system/
sudo systemctl enable --now go-transmission-stats.timer