{ "info": { "author": "Patrick C. McGinty", "author_email": "flacsync@tuxcoder.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: GNU General Public License (GPL)", "Operating System :: OS Independent", "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Topic :: Multimedia :: Sound/Audio :: Conversion" ], "description": "Recursively mirror a directory tree of FLAC audio files to AAC/OGG/MP3.\nSource files can be filtered (by sub-directory, or full path) in order to\nlimit the files converted. The script will also attempt to retain all\nmeta-data fields in the output files.\n\nAt a Glance\n===========\n\n* Mirror directory tree of FLAC files audio files to AAC/OGG/MP3 (re-encoded\n using NeroAacEnc, oggenc, or LAME).\n* Filter source tree using one or more sub-directory paths.\n* By default, will only re-encode missing or out-of-date AAC/OGG/MP3 files.\n* Optionally deletes orphaned output files.\n* Multi-threaded encoding ensures full CPU utilization.\n* Supports transfer of FLAC meta-data including *title*, *artist*, *album*.\n* Converts FLAC replaygain field to Apple iTunes Sound Check.\n* Optionally resizes and embeds album cover art JPEG files to destination\n files.\n* Optionally copy cover art to destination directories.\n\nUsage Model\n===========\n\n* Hard disk space is cheap, but flash-based media players are still limited\n in capacity.\n* Create a lossy encoded \"mirror\" of your music files for portability.\n* Setup a daily cron job to always keep your FLAC and AAC/OGG files\n synchronized.\n* Re-encode your FLAC library to different AAC/OGG bit-rates in one command.\n\nRunning and Options\n===================\n\nFlacsync is run from the command-line, using the following format. ::\n\n flacsync [options] BASE_DIR [SOURCE ...]\n\n``BASE_DIR``\n\nDefine the root path of a directory hierarchy containing desired input files\n(FLAC). A mirrored output directory will be created in the deepest path,\nparallel to ``BASE_DIR``, and named after the selected output file\nextension.\n\nFor example, if ``BASE_DIR`` is ``/data/flac``, the output dir will be\n``/data/aac``.\n\n``SOURCE ...``\n\nOptional dir/file argument list to select source files for transcoding. If\nnot defined, all files in ``BASE_DIR`` will be transcoded. The ``SOURCE``\nfile/dir list must be relative from ``BASE_DIR`` or the current working\ndirectory.\n\n--version show program's version number and exit\n\n-h, --help show this help message and exit\n\n-c THREAD_COUNT, --threads=THREAD_COUNT\n set max number of encoding threads [default:2]\n\n-f, --force force re-encode of all files from the source dir; by\n default source files will be skipped if it is\n determined that an up-to-date copy exists in the\n destination path\n\n-t ENC_TYPE, --type=ENC_TYPE\n select the output transcode format; supported values\n are 'aac','ogg','mp3' [default:aac]\n\n-o, --ignore-orphans\n prevent the removal of files and directories in the\n dest dir that have no corresponding source file\n\n-d DEST_DIR, --destination=DEST_DIR\n define alternate destination output directory to\n override the default. The standard default destination\n directory will be created in the same parent directory\n of BASE_DIR. See BASE_DIR above.\n\n-r, --resize enable resizing of cover art; by default the art that\n is found will be saved to file without resizing.\n\n-j, --copy-cover-art\n in addition to embedding cover art, copy image file\n directly to the desination sub-folder.\n\n\nAAC Encoder Options:\n---------------------\n\n -q AAC_Q, --aac-quality=AAC_Q\n set the AAC encoder quality value, must be a float\n range of 0..1 [default:0.35]\n\nOGG Encoder Options:\n--------------------\n -g OGG_Q, --ogg-quality=OGG_Q\n set the Ogg Vorbis encoder quality value, must be a\n float range of -1..10 [default:5]\n\nMP3 Encoder Options:\n--------------------\n -m MP3_Q, --mp3-quality=MP3_Q\n set the Lame MP3 encoder quality value, must be a\n initeger range of 0..9 [default:3]\n\n\nExamples\n========\n\n1. Encode a directory of FLAC files to AAC. Output file will be written to\n ``/music/aac``.\n ::\n\n flacsync /music/flac\n cd /music/flac; flacsync .\n\n2. Encode a directory of FLAC files to AAC. Output files will be written to\n ``/ipod``.\n ::\n\n flacsync -d /ipod /music/flac\n\n3. Encode a directory of FLAC files to high-quality OGG, using 4 CPU\n threads.\n ::\n\n flacsync -c 4 -t ogg -g 9 /music/flac\n\n4. Force re-encode two albums of FLAC files, even if the AAC files exist.\n ::\n\n flacsync -f /music/flac artist1/album artist2/album\n cd /music/flac; flacsync -f . artist1/album artist2/album", "description_content_type": null, "docs_url": "https://pythonhosted.org/flacsync/", "download_url": "https://github.com/cmcginty/flacsync/raw/master/dist/flacsync-0.3.2.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://packages.python.org/flacsync/", "keywords": "flac aac conversion transcode compressedaudio ipod soundcheck replaygain albumart metaflac tags neroaacenc ogg music", "license": "UNKNOWN", "maintainer": null, "maintainer_email": null, "name": "flacsync", "package_url": "https://pypi.org/project/flacsync/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/flacsync/", "project_urls": { "Download": "https://github.com/cmcginty/flacsync/raw/master/dist/flacsync-0.3.2.tar.gz", "Homepage": "http://packages.python.org/flacsync/" }, "release_url": "https://pypi.org/project/flacsync/0.3.2/", "requires_dist": null, "requires_python": null, "summary": "Recursively mirror a directory tree of FLAC audio files to AAC or OGG.", "version": "0.3.2" }, "last_serial": 3091831, "releases": { "0.1": [], "0.2": [], "0.2.1": [], "0.2.2": [], "0.3": [], "0.3.0": [], "0.3.1": [], "0.3.2": [] }, "urls": [] }