Metadata-Version: 1.1
Name: ztfy.media
Version: 0.1.10
Summary: ZTFY medias handling package
Home-page: http://hg.ztfy.org/ztfy.media
Author: Thierry Florac
Author-email: tflorac@ulthar.net
License: zpl
Description: .. contents::
        
        Introduction
        ============
        
        ztfy.media is a ZTK/ZopeApp ZTFY package used to automatically convert and display
        medias files (audios, videos...).
        
        It was developed in the context of a medias library management application handling several
        kinds of medias (mainly images, videos, and audio files), to be able to automatically display
        these contents in web pages.
        
        
        Medias conversions
        ==================
        
        Automatic medias conversions implies several pre-requisites:
        
         - the ''ffmpeg'' executable must be available in your path;
        
         - you have to rely on a ZEO connection handling a blobs cache directory;
        
         - you have to create and register (with a name) this ZEO connection in your site management folder
           (see ztfy.utils.zodb.ZEOConnection object);
        
         - you have to create and register (without name) a ZTFY medias conversion utility.
        
        Medias conversion utility allows you to define listening address and port of a ZeroMQ process which
        will wait for conversions requests. These requests are automatically done when an IObjectAddedEvent
        is notified on a IFile object containing contents for which a converter has been registered; default
        converters based on FFmpeg are available for images, video and audio files, but you can provide your
        own converters for any kind of custom file.
        
        Medias conversion utility also allows to define in which formats you want to convert the new medias.
        All conversions are actually done with the help of FFmpeg, each conversion being done in a dedicated
        sub-process handling it's own ZEO connection.
        
        Converted medias are stored in the ZODB as Blob files in the original media file annotations.
        
        
        - Thierry Florac <tflorac@ulthar.net> - Author
        
        
        HISTORY
        =======
        
        0.1.10
        ------
         - corrected conversions code (based on "pyams_media" package source code) to use libAV 'avconv/avprobe' tools
         - added MP4 and WebM conversions options
         - updated FlowPlayer to release 6.0.5
         - updated medias previews
        
        0.1.9
        -----
         - corrected video frame size names array
        
        0.1.8
        -----
         - added small check in requested formats
        
        0.1.7
        -----
         - use new "getMagicContentType()" function from ztfy.extfile package
         - use non-empty suffix when detected content-type is unknown
        
        0.1.6
        -----
         - added flush on some video output files
         - added sound file thumbnail in audio preview
         - always use temporary files for Quicktime video conversions
        
        0.1.5
        -----
         - automatically include a video player watermark on videos thumbnails
         - updated video preview template
        
        0.1.4
        -----
         - reset video bitrate command line option to "-b" (instead of "-b:v") to be compatible
           with all FFmpeg versions
         - updated video preview for Firefox compatibility
        
        0.1.3
        -----
         - added one second before checking ZMQ processes startup
         - updated package resources
        
        0.1.2
        -----
         - register ZMQ medias converter process exit callback
        
        0.1.1
        -----
         - removed forgotten 'print' statement
         - update README
        
        0.1.0
        -----
         - first release
        
Keywords: ZTFY audio video ffmpeg flowplayer
Platform: UNKNOWN
Classifier: Programming Language :: Python
