Skip to main content

An asynchronous image/file downloader and thread archiver for Futaba-styled imageboards, such as 4chan and 8chan.

Project description

![Chandere][img_1] ## A command-line utility programmed and maintained by [Jakob.][1] An extremely modular asynchronous archiving tool for various imageboards, textboards, and Boorus.

Chandere 2.5.0 is currently in the alpha state of development, and is likely to bring many bugs. See [HACKING.md][2] for information on reporting issues.

Chandere is free software, licensed under the [GNU General Public License.][3]

[![Build Status](https://travis-ci.org/TsarFox/chandere.svg?branch=master)](https://travis-ci.org/TsarFox/chandere) [![PyPI Version](https://img.shields.io/pypi/v/Chandere.svg)](https://pypi.python.org/pypi/Chandere/) [![AUR Version](https://img.shields.io/aur/version/chandere.svg)](https://aur.archlinux.org/packages/chandere/) [![License](https://img.shields.io/github/license/tsarfox/chandere.svg)](https://www.gnu.org/licenses/gpl.html)

# Websites Supported by the Default Distribution * 4chan

# Features Supported by the Default Distribution * Downloading all files present.

# Installation Arch Linux users are encouraged to install Chandere using Pacman, as it is packaged in the [AUR.][4]

` $ # If the PKGBUILD is in the current working directory: $ makepkg -si `

If you are running a distribution for which Chandere is not yet packaged, or are not running Linux, the recommended means of installation is through Pip.

` $ # It is recommended that you use the latest version of pip and setuptools when installing Chandere. # pip install --upgrade pip setuptools # pip install --upgrade chandere `

setup.py in the repository’s root directory can be used if Pip is not available, however this is not recommended.

` # python setup.py install `

If Chandere is installed with Pip or setup.py, manpages will have to be manually moved to your manpath.

` $ make doc # cp docs/*.1.gz /usr/share/man/man1 # The destination path may be different on your system. `

# Examples

` chandere /fit/17018018 `

Download all images from ‘https://boards.4chan.org/fit/thread/17018018/’ into the current working directory, preserving the original filenames.

` chandere -o "{index}.{ext}" /fit/17018018 `

Perform the same as the above, but instead save every image to a filename containing the index at which it was encountered.

` chandere /tech/ -w 8chan `

Download all images from ‘https://8ch.net/tech/res/589254.html’.

# Extending

See [HACKING.md][2].

# TODO

  • Fix ordering of TARGETS.

  • Expose an API such that Chandere can be used as a library.

[1]: http://jakob.space/ [2]: https://github.com/TsarFox/chandere/blob/master/HACKING.md [3]: http://gnu.org/licenses/gpl.html [4]: https://aur.archlinux.org/packages/chandere/

[img_1]: https://raw.githubusercontent.com/TsarFox/chandere/master/chandere_logo.png

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Chandere-2.5.0a1.tar.gz (23.1 kB view hashes)

Uploaded Source

Built Distribution

Chandere-2.5.0a1-py3-none-any.whl (14.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page