Xirvik Tools¶
Command line utilities for interfacing with Xirvik.
Commands¶
xirvik¶
Root command.
Usage
xirvik [OPTIONS] COMMAND [ARGS]...
Options
- -C, --config <config>¶
Configuration file
- -H, --host <host>¶
Xirvik host (without protocol)
ftp¶
Commands for managing the FTP server.
Usage
xirvik ftp [OPTIONS] COMMAND [ARGS]...
add-ftp-user¶
Add an FTP user.
Usage
xirvik ftp add-ftp-user [OPTIONS] USERNAME PASSWORD
Options
- -p, --port <port>¶
Server port.
- -d, --debug¶
Enable debug level logging.
- -r, --root-directory <root_directory>¶
Root directory for the FTP user.
- -H, --host <host>¶
Xirvik host (without protocol).
- -C, --config <config>¶
Configuration file.
Arguments
- USERNAME¶
Required argument
- PASSWORD¶
Required argument
delete-ftp-user¶
Delete an FTP user.
Usage
xirvik ftp delete-ftp-user [OPTIONS] USERNAME
Options
- -p, --port <port>¶
Server port.
- -d, --debug¶
Enable debug level logging.
- -H, --host <host>¶
Xirvik host (without protocol).
- -C, --config <config>¶
Configuration file.
Arguments
- USERNAME¶
Required argument
list-ftp-users¶
List FTP users.
Usage
xirvik ftp list-ftp-users [OPTIONS]
Options
- -p, --port <port>¶
Server port.
- -d, --debug¶
Enable debug level logging.
- -H, --host <host>¶
Xirvik host (without protocol).
- -C, --config <config>¶
Configuration file.
rtorrent¶
Commands for managing rTorrent.
Usage
xirvik rtorrent [OPTIONS] COMMAND [ARGS]...
download-untracked-files¶
Download untracked files using rsync.
Usage
xirvik rtorrent download-untracked-files [OPTIONS] UNTRACKED_FILENAME TARGET
Options
- -H, --host <host>¶
Xirvik host (without protocol).
- -p, --port <port>¶
Server port.
- -d, --debug¶
Enable debug level logging.
- -u, --username <username>¶
SSH user name.
Arguments
- UNTRACKED_FILENAME¶
Required argument
- TARGET¶
Required argument
fix-rtorrent¶
Restart the rtorrent service in case ruTorrent cannot connect to it.
Usage
xirvik rtorrent fix-rtorrent [OPTIONS]
Options
- -H, --host <host>¶
Xirvik host (without protocol).
- -C, --config <config>¶
Configuration file.
- -p, --port <port>¶
Server port.
- -d, --debug¶
Enable debug level logging.
install-services¶
Install the xirvik-start-torrents service.
Usage
xirvik rtorrent install-services [OPTIONS] [DIRECTORIES]...
Options
- -d, --debug¶
Enable debug level logging.
- -i, --interval <interval>¶
Interval in minutes to check for new torrents.
- -H, --host <host>¶
Required Xirvik host (without protocol).
Arguments
- DIRECTORIES¶
Optional argument(s)
list-all-files¶
List every tracked file.
Usage
xirvik rtorrent list-all-files [OPTIONS]
Options
- -H, --host <host>¶
Xirvik host (without protocol).
- -C, --config <config>¶
Configuration file.
- -p, --port <port>¶
Server port.
- -d, --debug¶
Enable debug level logging.
list-files¶
List a torrent’s files in a given format.
Usage
xirvik rtorrent list-files [OPTIONS] HASH
Options
- -H, --host <host>¶
Xirvik host (without protocol).
- -C, --config <config>¶
Configuration file.
- -p, --port <port>¶
Server port.
- -d, --debug¶
Enable debug level logging.
- -I, --no-headers¶
Omit table headers.
- -F, --table-format <table_format>¶
Output table format.
- Options:¶
asciidoc | colon_grid | double_grid | double_outline | fancy_grid | fancy_outline | github | grid | heavy_grid | heavy_outline | html | jira | latex | latex_booktabs | latex_longtable | latex_raw | mediawiki | mixed_grid | mixed_outline | moinmoin | orgtbl | outline | pipe | plain | presto | pretty | psql | rounded_grid | rounded_outline | rst | simple | simple_grid | simple_outline | textile | tsv | unsafehtml | youtrack | json
- -R, --reverse-order¶
Reverse the sort order.
Arguments
- HASH¶
Required argument
list-torrents¶
List torrents in a given format.
Usage
xirvik rtorrent list-torrents [OPTIONS]
Options
- -H, --host <host>¶
Xirvik host (without protocol).
- -C, --config <config>¶
Configuration file.
- -p, --port <port>¶
Server port.
- -d, --debug¶
Enable debug level logging.
- -I, --no-headers¶
Omit table headers.
- -F, --table-format <table_format>¶
Output table format.
- Options:¶
asciidoc | colon_grid | double_grid | double_outline | fancy_grid | fancy_outline | github | grid | heavy_grid | heavy_outline | html | jira | latex | latex_booktabs | latex_longtable | latex_raw | mediawiki | mixed_grid | mixed_outline | moinmoin | orgtbl | outline | pipe | plain | presto | pretty | psql | rounded_grid | rounded_outline | rst | simple | simple_grid | simple_outline | textile | tsv | unsafehtml | youtrack | json
- -S, --sort <sort>¶
Field to sort by.
- Options:¶
name | hash | label | creation_date | state_changed | finished
- -R, --reverse-order¶
Reverse the sort order.
list-untracked-files¶
List all files on the server that are not tracked.
Usage
xirvik rtorrent list-untracked-files [OPTIONS]
Options
- -H, --host <host>¶
Xirvik host (without protocol).
- -p, --port <port>¶
Server port.
- -L, --server-list-command <server_list_command>¶
This should be a command that outputs lines where each line is a complete file path that matches the “torrents/<username>/…” output from ruTorrent’s API. An example using SSH:
ssh name-of-server ‘find /media/sf_hostshare -type f’ | sed -re ‘s|^/media/sf_hostshare|/torrents/username|g’.
- -d, --debug¶
Enable debug level logging.
main¶
Delete torrents based on certain criteria.
Usage
xirvik rtorrent main [OPTIONS]
Options
- -u, --username <username>¶
Xirvik user.
- -p, --password <password>¶
Xirvik password.
- -r, --max-retries <max_retries>¶
Number of retries for each request (passed to client).
- -d, --debug¶
Enable debug level logging.
- --backoff-factor <backoff_factor>¶
Back-off factor used when calculating time to wait to retry a failed request.
- --netrc <netrc>¶
netrc file path.
- -C, --config <config>¶
Configuration file.
- -H, --host <host>¶
Xirvik host (without protocol).
- --days <days>¶
- --label <label>¶
- --max-attempts <max_attempts>¶
- --sleep-time <sleep_time>¶
- -D, --ignore-date¶
- -a, --ignore-ratio¶
- -y, --dry-run¶
main¶
Move torrents according to labels assigned.
Usage
xirvik rtorrent main [OPTIONS]
Options
- -u, --username <username>¶
Xirvik user.
- -p, --password <password>¶
Xirvik password.
- -r, --max-retries <max_retries>¶
Number of retries for each request (passed to client).
- -d, --debug¶
Enable debug level logging.
- --backoff-factor <backoff_factor>¶
Back-off factor used when calculating time to wait to retry a failed request.
- --netrc <netrc>¶
netrc file path.
- -C, --config <config>¶
Configuration file.
- -H, --host <host>¶
Xirvik host (without protocol).
- -b, --batch-size <batch_size>¶
Batch size.
- -c, --completed-dir <completed_dir>¶
Top directory where moved torrent data will be placed.
- -t, --sleep-time <sleep_time>¶
Time to sleep in seconds at certain times during this batch of requests.
- -l, --lower-label¶
Call lower() on labels used to make directory names.
- --ignore-labels <ignore_labels>¶
List of labels to ignore (case-sensitive).
main¶
Move torrents in error state to another location.
Usage
xirvik rtorrent main [OPTIONS]
Options
- -u, --username <username>¶
Xirvik user.
- -p, --password <password>¶
Xirvik password.
- -r, --max-retries <max_retries>¶
Number of retries for each request (passed to client).
- -d, --debug¶
Enable debug level logging.
- --backoff-factor <backoff_factor>¶
Back-off factor used when calculating time to wait to retry a failed request.
- --netrc <netrc>¶
netrc file path.
- -C, --config <config>¶
Configuration file.
- -H, --host <host>¶
Xirvik host (without protocol).
- --sleep-time <sleep_time>¶
Time to sleep between batches in seconds.
start-torrents¶
Upload torrent files to the server.
Usage
xirvik rtorrent start-torrents [OPTIONS] [DIRECTORIES]...
Options
- --no-verify¶
Disable TLS verification (not recommended).
- --start-stopped¶
Start torrents in stopped state.
- -C, --config <config>¶
Configuration file.
- -H, --host <host>¶
Xirvik host (without protocol).
- -d, --debug¶
Enable debug level logging.
- -p, --port <port>¶
Server port.
- -s, --syslog¶
Enable syslog logging.
Arguments
- DIRECTORIES¶
Optional argument(s)
vm¶
Commands for the Linux virtual machine.
Usage
xirvik vm [OPTIONS] COMMAND [ARGS]...
authorize-ip¶
Authorise the current IP for access to the VM via SSH/VNC/RDP.
Usage
xirvik vm authorize-ip [OPTIONS]
Options
- -p, --port <port>¶
Server port.
- -d, --debug¶
Enable debug level logging.
- -H, --host <host>¶
Xirvik host (without protocol).
- -C, --config <config>¶
Configuration file.
Contents: