A minimal, secure, command-line tool for interfacing with XDCC senders.
usage: xget [-A|--no-acknowledge] [-O|--output-document] <uri> <nick> send <pack>
In its most basic form, xget accepts a number of arguments: an IRC URI, which denotes the hostname, scheme, port number, and IRC channels to join; the XDCC-sending nick name; send
, the XDCC command; and the pack number to request.
The URI format is irc:https://HOSTNAME[:PORT]/[#]CHANNEL[,[#]CHANNEL...]
. If the port number is not specified, the port number TCP/6667 will be used. The URI may contain one or more IRC channels—optionally prefixed with an octothorpe (#
)—each of which will be joined.
The -A
, --no-acknowledge
option may be used to suppress xget from returning file offsets as acknowledgements. Although it is DCC protocol to send these acknowledgements, many DCC senders don't require them—some will even abort the DCC transfer if too many acknowledgements are sent.
The -O
, --output-document
option may be used to create the file with a given name, instead of the name provided by the DCC sender. This option requires one argument: the new name and/or path of the file to be downloaded.
Request pack #34 from nick super-duper-bot with XDCC SEND
on the IRC network irc.sampel.net, after joining the IRC channel #best-channel.
xget irc:https://irc.sampel.net/#best-channel super-duper-bot send 34
Request pack #34 from nick super-duper-bot with XDCC SEND
on the IRC network irc.sampel.net, connected via port TCP/1337, after joining the IRC channel #best-channel.
xget irc:https://irc.sampel.net:1337/#best-channel super-duper-bot send 34
Request pack #34 from nick super-duper-bot with XDCC SEND
on the IRC network irc.sampel.net, after joining the IRC channels #best-channel and #best-chat-channel.
xget irc:https://irc.sampel.net/#best-channel,#best-chat-channel super-duper-bot send 34
- GNU/Linux
- OpenBSD
- FreeBSD
- macOS
meson setup build
ninja -C build
You'll need the compile-time dependency libbsd (or libbsd-dev). On Ubuntu and Debian, you can install this dependency with:
sudo apt install libbsd-dev