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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file Chandere-2.5.0a1.tar.gz.

File metadata

  • Download URL: Chandere-2.5.0a1.tar.gz
  • Upload date:
  • Size: 23.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Chandere-2.5.0a1.tar.gz
Algorithm Hash digest
SHA256 48d69a48be154a20afa041eba14b629172d7328b53c7d9c5524f918ea9c553d2
MD5 5e623263c82f3031f6769dfd04537d49
BLAKE2b-256 c68a5857ee25f086e25d1d9a259afbe90ba6b3efd63dcc12196bc0a875f2d4f6

See more details on using hashes here.

File details

Details for the file Chandere-2.5.0a1-py3-none-any.whl.

File metadata

File hashes

Hashes for Chandere-2.5.0a1-py3-none-any.whl
Algorithm Hash digest
SHA256 933e7178d33783bd34ae0b705ef24203bcece10d6f7eb076990591cc0d30d1ec
MD5 c61304d58c91d76acf0f7e8263aa00b4
BLAKE2b-256 b557671a3ec80a14815ee3e70011eab4f49bc09afb52c540e2207b5b2eb33cbe

See more details on using hashes here.

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