Skip to main content

XDCC Downloader

master develop
build status build status

Logo

An XDCC File downloader based on the irclib framework.

Installation

Either install the program using pip install xdcc-dl or python setup.py install

Please not that python 2 is no longer supported, the project requires python 3 to run.

Usage

Message-based CLI

XDCC Packlists usually list xdcc commands in the following form:

/msg <BOTNAME> xdcc send #<PACKNUMBER>

By supplying this message as a positional parameter, the pack can be downloaded.

Examples:

# This is the xdcc message:  '/msg the_bot xdcc send #1'

# This command downloads pack 1 from the_bot
$ xdcc-dl "/msg the_bot xdcc send #1"

# It's possible to download a range of packs (1-10 in this case):
$ xdcc-dl "/msg the_bot xdcc send #1-10"

# Range stepping is also possible:
$ xdcc-dl "/msg the_bot xdcc send #1-10;2"
# (This will download packs 1,3,5,7,9)

# Explicitly specifying the packs to download as a comma-separated list:
$ xdcc-dl "/msg the_bot xdcc send #1,2,5,8"
# (This will download packs 1,2,5,8)

# you can also specify the destination file or directory:
$ xdcc-dl "/msg the_bot xdcc send #1" -o /home/user/Downloads/test.txt

# if the bot is on a different server than irc.rizon.net, a server
# has to be specified:
$ xdcc-dl "/msg the_bot xdcc send #1" --server irc.freenode.org

# To specify different levels of verbosity, pass the `--verbose` or
# `--quiet` flag
$ xdcc-dl -v ...
$ xdcc-dl -q ...

As a library:

xdcc-dl is built to be used as a library for use in other projects. To make use of the XDCC downloader in your application, you will first need to create a list of XDCCPack objects.

This can be done manually using the constructor, the XDCCPack.from_xdcc_message class method or by using an XDCC Search Engine

Once this list of XDCCPacks is created, use the download_packs function in the xdcc module.

An example on how to use the library is listed below:

from xdcc_dl.xdcc import download_packs
from xdcc_dl.pack_search import SearchEngines
from xdcc_dl.entities import XDCCPack, IrcServer

# Generate packs
manual = XDCCPack(IrcServer("irc.rizon.net"), "bot", 1)
from_message = XDCCPack.from_xdcc_message("/msg bot xdcc send #2-10")
search_results = SearchEngines.SUBSPLEASE.value.search("Test")
combined = [manual] + from_message + search_results

# Start download
download_packs(combined)

Projects using xdcc-dl

Further Information

Metadata

Release files for xdcc-dl 5.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xdcc-dl 5.2.1
File Size Uploaded
xdcc-dl-5.2.1.tar.gz 31.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for xdcc-dl 5.2.1
File Interpreter ABI Platform
xdcc_dl-5.2.1-py3-none-any.whl Python 3 none any Details

Total release size: 75.7 kB

Release files / xdcc-dl-5.2.1.tar.gz

Download URL xdcc-dl-5.2.1.tar.gz
Size 31.1 kB
Tags Source
SHA-256 checksum
How to use checksums
ea1f27f9f0d57232600eea55cdc9ab44e98ef16b7e5d5c7f535ef1520680a1d4
BLAKE2b-256 checksum
How to use checksums
3c4a38db7d921c8b6c3aa69ccd63dc6c239019c3c04e7cfc86d9dcceb69b645f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.8.10

Release files / xdcc_dl-5.2.1-py3-none-any.whl

Download URL xdcc_dl-5.2.1-py3-none-any.whl
Size 44.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cf0a074dd503b853e65a8f4b23828601d97f5bf4770db7af4d4109ea7745a7b2
BLAKE2b-256 checksum
How to use checksums
0017d0587c3a7a684b2ea3745247cf8ac772101e07c839b2e87ca1258dee777c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.8.10

Release history Release notifications | RSS feed

This release

5.2.1 This release

2 release files

5.2.0

2 release files

5.1.0

2 release files

5.0.0

2 release files

4.0.0

2 release files

3.3.0

2 release files

3.2.0

2 release files

3.1.1

2 release files

3.1.0

2 release files

3.0.3

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.1.0

3 release files

2.0.0

3 release files

1.1.3

3 release files

1.1.2

3 release files

1.1.1

3 release files

1.1.0

1.0.1

3 release files

1.0.0

3 release files

0.5.0

3 release files

0.4.0

3 release files

0.3.0

3 release files

0.2.0

3 release files

0.1.0

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page