Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ostafen/xdcc-cli
A command line tool for searching and downloading files from the IRC network.
https://github.com/ostafen/xdcc-cli
golang irc-bot irc-protocol xdcc
Last synced: 19 days ago
JSON representation
A command line tool for searching and downloading files from the IRC network.
- Host: GitHub
- URL: https://github.com/ostafen/xdcc-cli
- Owner: ostafen
- License: gpl-2.0
- Created: 2021-11-18T18:43:14.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-01-04T18:21:59.000Z (11 months ago)
- Last Synced: 2024-10-14T19:48:23.470Z (about 1 month ago)
- Topics: golang, irc-bot, irc-protocol, xdcc
- Language: Go
- Homepage:
- Size: 67.4 KB
- Stars: 32
- Watchers: 5
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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 **make** command to build an executable:
```bash
git clone https://github.com/ostafen/xdcc-cli.git
cd xdcc-cli
make # this will ouput a bin/xdcc executable
```
## 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.