Metadata-Version: 1.1
Name: BA-4chan-thread-archiver
Version: 0.6.3
Summary: 4chan API-based complete thread archiver
Home-page: https://github.com/bibanon/4chandownloader
Author: Lawrence Wu
Author-email: sagnessagiel@gmail.com
License: 4chandownloader
Copyright (C) 2012 Geoffrey Lehée [http://geoffrey.lehee.name/]

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
Description: BA 4chan API Thread Archiver
        ===============
        
        `Github <https://github.com/bibanon/BA-4chan-thread-archiver>`_
        
        This script uses the `4chan API <https://github.com/4chan/4chan-API>`_ to:
        
        * Download all images and/or thumbnails in a certain thread.
        * Download a JSON dump of thread comments using the 4chan API.
        * Download the HTML page
        * Convert links in HTML to use the downloaded images
        * Download CSS and convert HTML to use them
        * Keep downloading until 404 (with a user-set delay)
        * Can be restarted at any time
        
        This script is designed to replace "Right-click Save As, Web Page Complete" when saving 4chan threads, since it does not save full-sized images or JSON. 
        
        It can also be used as a far lighter, static HTML alternative to Fuuka.
        
        Part of the JSON-based-chanarchiver by Lawrence Wu, built 2013/04/04.
        
        Usage
        ============
        
        ::
        
            Usage:
              4chan-thread-archiver <url> [--path=<string>] [--delay=<int>] [--nothumbs] [--thumbsonly]
              4chan-thread-archiver -h | --help
              4chan-thread-archiver -v | --version
        
            Options:
              --nothumbs          Don't download thumbnails
              --thumbsonly        Download thumbnails, no images
              --delay=<int>       Delay between thread checks [default: 20]
              -h --help           Show help
              -v --version        Show version
        
        By default, the script saves to the folder ``4chan`` in the current working directory.
        
        Installation
        ============
        
        Linux/Mac
        ---------
        
        Install Python on your computer. On Linux, Python is almost always preinstalled; however, you will also have to install the program ``pip`` from the repositories to install the necessary packages.
        
        ::
        
            easy_install pip
            pip install BA-4chan-thread-archiver
        
        Windows
        -------
        
        > **Note:** Unfortunately, this script just flat out fails to run in Windows. We need some help figuring out why...
        
        1. Install `Python 2.7.` <http://python.org/download/>_ 32-bit version is recommended
        2. Install `pip1.6` <https://sites.google.com/site/pydatalog/python/pip-for-windows> using the linked easy installer.
        3. Follow the instructions on that site to install the package `BA-4chan-thread-archiver`
        
        ::
        
            pip install BA-4chan-thread-archiver
            
        Example
        =======
        
        ::
        
            4chan-thread-archiver http://boards.4chan.org/b/res/423861837 --path=4chan-threads --delay 5 --thumbsonly
        
        Modifications to original
        ============
        
        Originally forked from Socketub's `4chan-thread-archiver. <https://github.com/socketubs/4chan-thread-archiver>`_ 
        
        However, all the original has long since been replaced, and the scripts are totally different. Here is a list of additions:
        
        * Based on `py4chan <https://github.com/e000/py-4chan>`_
        * Downloads HTML dump of thread
        * New --thumbsonly option to download thumbnails and no images
        * Code modularization
        * More comments in code
        * Support for new 4cdn.org server
        
        More info and a full journal can be found in ``log.md``.
        
        Wishlist
        =========
        
        * Prompt user for metadata information.
        * Define the ``.chan.zip`` format for 4chan thread archive transfer
        * Create a PyQt GUI
        
Keywords: 4chan downloader images json dump
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
