Metadata-Version: 1.1
Name: picopt
Version: 1.0.0
Summary: Optimize image files and comic archives with external tools
Home-page: https://github.com/ajslater/picopt/
Author: AJ Slater
Author-email: aj@slater.net
License: GPLv2
Description: picopt
        ======
        
        A multi-format, recursive, multiprocessor aware, command line image
        optimizer utility that uses external tools to do the optimizing.
        
        Picopt depends on Python
        `PIL <http://www.pythonware.com/products/pil/>`__ to identify files and
        `rarfile <https://pypi.python.org/pypi/rarfile>`__ to open CBRs.
        
        To optimize JPEG images. Picopt needs either
        `jpegrescan <https://github.com/kud/jpegrescan>`__ or
        `jpegtran <http://jpegclub.org/jpegtran/>`__ on the path. jpegrescan is
        preferred.
        
        To optimize lossless images like PNG, PNM, GIF, TIFF and BMP, picopt
        requires either `optipng <http://optipng.sourceforge.net/>`__,
        `advpng <http://advancemame.sourceforge.net/doc-advpng.html>`__ or
        `pngout <http://advsys.net/ken/utils.htm>`__ be on the path. optipng
        provides the most advantage, but best results are acheived by using both
        utilities. advpng support is disabled by default and must be explicitly
        enabled on the command line.
        
        Animated GIFs are optimized with
        `gifsicle <http://www.lcdf.org/gifsicle/>`__ if it is available.
        
        Picopt uncompresses, optimizes and rezips `comic book archive
        files <https://en.wikipedia.org/wiki/Comic_book_archive>`__. Be aware
        that CBR rar archives will be rezipped into CBZs instead of CBR.
        
        Picopt allows you to drop picopt timestamps at the root of your
        recursive optimization trees so you don't have to remember which files
        to optimize or when you last optimized.
        
        Installation
        ------------
        
        Lossless external programs
        ~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        OS X
        ^^^^
        
        ::
        
            brew install optipng pngout jpeg gifsicle
        
        Debian / Ubuntu
        ^^^^^^^^^^^^^^^
        
        ::
        
            apt-get install optipng pngout libjpeg-progs gifsicle
        
        Redhat / Fedora
        ^^^^^^^^^^^^^^^
        
        ::
        
            yum install optipng pngout libjpeg-progs gifsicle
        
        jpegrescan
        ~~~~~~~~~~
        
        ::
        
            git clone git@github.com:kud/jpegrescan.git
            ln -s jpegrescan/jpegrescan /usr/local/bin/jpegrescan
        
        Dependancies
        ~~~~~~~~~~~~
        
        Debian / Ubuntu
        ^^^^^^^^^^^^^^^
        
        ::
        
            apt-get install python-imaging
        
        Picopt
        ~~~~~~
        
        ::
        
            pip install picopt
        
        Usage
        -----
        
        Optimize files:
        
        ::
        
            picopt *.jpg
        
        Optimize files and recurse directories:
        
        ::
        
            picotpt -r *
        
        Optimize files and recurse directories AND optimize comic book archives:
        
        ::
        
            picopt -rc *
        
        Optimize files, but not lossless files:
        
        ::
        
            picopt -op *
        
        Optimize files, but not jpegs:
        
        ::
        
            picopt -jt *
        
        Optimize files, but not animated gifs:
        
        ::
        
            picopt -g *
        
        Just list files picopt.py would try to optimize:
        
        ::
        
            picopt -l *
        
        Optimize everything in my iPhoto library, but only after the last time i
        did this, skipping symlinks to avoid massive amounts of duplicate work.
        Don't convert lossless files to PNGs because that would confuse iPhoto.
        Also drop a timestamp file so I don't have to remeber the last time I
        did this:
        
        ::
        
            picopt -rSCT -D '2013 June 1 14:00' 'Pictures/iPhoto Library'
        
        Packaged For
        ------------
        
        -  `PyPI <https://pypi.python.org/pypi/picopt/0.13.1>`__
        -  `Arch Linux <https://aur.archlinux.org/packages/picopt/>`__
        
        Alternatives
        ------------
        
        `imageoptim <http://imageoptim.com/>`__ is an OS X GUI optimizer. It
        integrates the various optimization programs so you don't have to
        install them separately. It does not handle comic book archives. Its
        drag'n'drop UI is pretty nice. It also has AdvPNG support which I've
        disabled in picopt because I've never seen it provide any advantage.
        Command line usage is possible with `an external
        program <https://code.google.com/p/imageoptim/issues/detail?can=2&start=0&num=100&q=&colspec=ID%20Type%20Status%20Priority%20Milestone%20Owner%20Summary%20Stars&groupby=&sort=&id=39>`__.
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: Natural Language :: English
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
