Skip to content
This repository has been archived by the owner on Jun 5, 2023. It is now read-only.

Latest commit

 

History

History
61 lines (40 loc) · 2.41 KB

README.md

File metadata and controls

61 lines (40 loc) · 2.41 KB

xget

A minimal, secure, command-line tool for interfacing with XDCC senders.

Usage

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://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.

Examples

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://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://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://irc.sampel.net/#best-channel,#best-chat-channel super-duper-bot send 34

Supported Operating Systems:

  • GNU/Linux
  • OpenBSD
  • FreeBSD
  • macOS

Compiling xdccget

meson setup build
ninja -C build

GNU/Linux

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

C/C++ CI