51 lines
1.7 KiB
Markdown
51 lines
1.7 KiB
Markdown
# XDCC Command Line Tools
|
|
|
|
This project provides a simple command line tool which allow you to perform search and retrieval of files on the IRC network through the XDCC protocol. It is based on the popular [goirc](https://github.com/fluffle/goirc) library.
|
|
|
|
|
|
## Features
|
|
- File search from multiple search engines.
|
|
- It allows to download multiple files at the same time.
|
|
|
|
## Installation
|
|
|
|
Assuming you have the latest version of Go installed on your system, you can use the **buid** command to get an executable:
|
|
|
|
```bash
|
|
git clone https://github.com/ostafen/xdcc-cli.git
|
|
cd xdcc-cli
|
|
go build . -o xdcc
|
|
```
|
|
|
|
## Usage
|
|
To initialize a file search, simply pass a list of keywords to the **search** subcommand like so:
|
|
|
|
```bash
|
|
foo@bar:~$ xdcc search keyword1 keyword2 ...
|
|
```
|
|
|
|
For example, to search for the latest iso of ubuntu, you could simply write:
|
|
|
|
```bash
|
|
foo@bar:~$ xdcc search ubuntu iso
|
|
```
|
|
|
|
If the command succedeeds, a table, similar to the following, will be displayed:
|
|
|
|
| File Name | File Size | URL |
|
|
| :------: | :------: | :------: |
|
|
| ubuntu-20.04-desktop-amd64.iso | 2.50GB | ... |
|
|
| ... | ... | ... |
|
|
|
|
A part from file details, each row will contain an **url** of the form irc://network/channel/bot/slot, which identifies the file on the IRC network.
|
|
To download one or more file, simply pass a list of url to the **get** subcommand like so:
|
|
|
|
```bash
|
|
foo@bar:~$ xdcc get url1 url2 ... [-o /path/to/an/output/directory]
|
|
```
|
|
Alternatively, you could also specify a .txt input file, containing a list of urls (one for each line), using the **-i** switch.
|
|
|
|
## Notes
|
|
|
|
This software has been written as a development exercise and comes with no warranty. Use it at your own risk.
|
|
Moreover, the developer is not responsible for any illecit use of it. |