mirror of
https://codeberg.org/hyperreal/go-transmission-stats
synced 2024-11-01 08:43:10 +01:00
68 lines
1.8 KiB
Markdown
68 lines
1.8 KiB
Markdown
# 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:
|
|
|
|
```shell
|
|
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:
|
|
|
|
``` shell
|
|
git clone https://codeberg.org/hyperreal/go-transmission-stats
|
|
cd go-transmission-stats
|
|
go build
|
|
```
|
|
|
|
Move the binary to a location in PATH:
|
|
|
|
``` shell
|
|
sudo mv go-transmission-stats /usr/local/bin/
|
|
```
|
|
|
|
Create the systemd service:
|
|
``` ini
|
|
[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:
|
|
|
|
``` ini
|
|
[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:
|
|
|
|
``` shell
|
|
sudo mv go-transmission-stats.service go-transmission-stats.timer /etc/systemd/system/
|
|
sudo systemctl enable --now go-transmission-stats.timer
|
|
```
|