docs/README.txt
changeset 25 3ee119b3968f
parent 12 240f2efa4a1f
equal deleted inserted replaced
24:0f4851b0aef3 25:3ee119b3968f
     5 ============
     5 ============
     6 
     6 
     7 pyams_media is a Pyramid/PyAMS extension package used to automatically convert and
     7 pyams_media is a Pyramid/PyAMS extension package used to automatically convert and
     8 display medias, actually audio and video files.
     8 display medias, actually audio and video files.
     9 
     9 
    10 Medias conversion is based on FFmpeg binary, which must be available on the web server.
    10 Medias conversion is based on libAV tools, which must be available on the web server.
    11 
    11 
    12 
    12 
    13 Medias conversions
    13 Medias conversions
    14 ==================
    14 ==================
    15 
    15 
    16 Medias conversion implies several pre-requisites:
    16 Medias conversion implies several pre-requisites:
    17 
    17 
    18  - the ''ffmpeg'' executable must be available in your path;
    18  - the ''avconv'' and ''avprobe'' executables must be available in your path;
    19 
    19 
    20  - you have to rely a ZEO connection handling a blobs cache directory;
    20  - you have to rely a ZEO connection handling a blobs cache directory;
    21 
    21 
    22  - you have to create this ZEO connection in your PyAMS control panel.
    22  - you have to create this ZEO connection in your PyAMS control panel.
    23 
    23 
    32 in your configuration file under the key ''pyams_media.tcp_handler'', in the ''ip:port'' form. For example::
    32 in your configuration file under the key ''pyams_media.tcp_handler'', in the ''ip:port'' form. For example::
    33 
    33 
    34     pyams_media.tcp_handler = 127.0.0.1:5556
    34     pyams_media.tcp_handler = 127.0.0.1:5556
    35 
    35 
    36 PyAMS control panel allows you to define several conversion settings, for example to define which audio and video
    36 PyAMS control panel allows you to define several conversion settings, for example to define which audio and video
    37 formats should be available, as well as a few FFmpeg conversion settings (frame size, bitrate, sampling...).
    37 formats should be available, as well as a few libAV conversion settings (frame size, bitrate, sampling...).
    38 
    38 
    39 Conversion is launched automatically in the background as soon as a media file is added to any content. Converted
    39 Conversion is launched automatically in the background as soon as a media file is added to any content. Converted
    40 medias are stored in the ZODB as blob files in the original media file annotations.
    40 medias are stored in the ZODB as blob files in the original media file annotations.