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.

Files for Chandere, version 2.5.0a1
Filename, size File type Python version Upload date Hashes
Filename, size Chandere-2.5.0a1-py3-none-any.whl (14.1 kB) File type Wheel Python version 3.6 Upload date Hashes View
Filename, size Chandere-2.5.0a1.tar.gz (23.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page