{ "info": { "author": "Mkhanyisi Madlavana", "author_email": "mkhanyisi@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: End Users/Desktop", "Natural Language :: English", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "[![Build Status](https://travis-ci.org/dopstar/ftransc.svg?branch=master)](https://travis-ci.org/dopstar/ftransc) [![Python Version](https://img.shields.io/pypi/pyversions/ftransc.svg)](https://pypi.python.org/pypi/ftransc) [![PyPI Status](https://img.shields.io/pypi/v/ftransc.svg)](https://pypi.python.org/pypi/ftransc)\n\n# What is ftransc\n\n`ftransc` is the python audio conversion library. It can convert local files or files from youtube (even youtube playlists).\n\n\n## Installing ftransc\n\n\nftransc can be installed as follows:\n\n```\n pip install ftransc\n```\n\nThen FFMpeg must also installed as follows:\n\n- On Linux based systems:\n```\n sudo apt-get install ffmpeg lame flac vorbis-tools\n```\n\n- On Mac OS X:\n```\n brew install ffmpeg lame\n```\n\n\n\n## Examples \n\nExample 1 - converting from MP3 to OGG:\n```\n ftransc -f ogg filename.mp3\n```\nThe output file name for the above example will be 'filename.ogg'\n\nExample 2 - converting from MP3 to AAC, removing original file on success, using high quality preset:\n```\n ftransc -r -q extreme -f aac filename.mp3\n```\n\nExample 3 - extract audio content from a video files into the MP3 format, use best quality preset:\n```\n ftransc -q insane -f mp3 filename2.avi filename3.mpg filename4.vob ...\n```\n\nExample 4 - convert all audio files inside a given folder into WMA format. (This option is not recursive to child-folders)\n```\n ftransc -f wma --directory /path/to/folder_name\n```\n\nExample 5 - convert all audio audio files (and extract all audio content from video files) inside a given folder recursively including all sub-/child-folders, ftransc should be used with the 'find' command in the pipeline as follows:\n```\n find /path/to/folder_name -type f -print0 | xargs -0 ftransc -f aac -q high\n```\n\n## ftransc Quality Presets\n\nftransc uses quality presets called 'insane', 'extreme', 'high', 'normal', 'low', and 'tiny'. These presets are specified by the '-q' or '--quality' option of ftransc and are defined in the '/etc/ftransc/presets.conf' configuration file. \n\nThe `/etc/ftransc/presets.conf` presets file can be overriden by use of the --presets option and specify the custom presets file to use or, if you know what you are doing, make changes directly on the it.\n\n\n## ftransc Metadata Tags\n\nThe following is the list of supported tags across audio formats that ftransc can encode to. N means the tag is not supported and hence is lost during conversion. Y means the tag is supported and is present on the new file after conversion:\n\n| *tag* | *m4a* | *mp3* | *ogg* | *flac* | *wma* | *mpc* | *wav* | *wv* |\n|-------|-------|-------|-------|--------|-------|-------|-------|------|\n| title | Y\t| Y \t| Y \t| Y \t | Y\t | Y \t | N \t | Y \t|\n| artist | Y | Y | Y | Y | Y | Y | N | Y |\n| album | Y | Y | Y | Y | Y | Y | N | Y |\n| genre | Y | Y | Y | Y | Y | Y | N | Y |\n| date | Y | Y | Y | Y | Y | Y | N | Y |\n| tracknumber | Y | Y | Y | Y | Y | Y | N | Y |\n| composer | Y | Y | Y | Y | Y | Y | N | N |\n| publisher | N | Y | N | N | Y | N | N | N |\n| lyrics | Y | Y | N | N | Y | N | N | N |\n| album art | Y | Y | N | Y | N | N | N | N |\n| album artist | N | N | N | N | N | N | N | N |\n| comment | N | N | N | N | N | N | N | N |\n\n______\n\n## Screenshots\n\nThe image below shows `ftransc` command in action on Terminal as well as the ftransc manpage (`man ftransc`):\n\n![ftranansc_cli](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/ftransc_cli.png)\n\n_____\n\nftransc GUI front-end, *ftransc_qt*:\n\n![ftranansc_qt](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/ftransc_gui.png)\n\n_____\n\nftransc also uses Nautilus Scripts, so you can right click selection of files and convert like:\n\n![nautilus scripts](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/ftransc_nautilus-scripts.png)\n\n_____\n\n### ftransc plugin for Rhythmbox media player:\n\n- The ftransc plugin for rhythmbox media player allows one to send files from Rhythmbox music player to ftransc for conversion.\n![enabling plugin](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/rb_plugin0.png)\n\n____\n\n- Enabling the plugin:\n![enabling plugin](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/rb_plugin1.png)\n\n____\n\n- Converting songs with ftransc from Rhythmbox\n![using plugin](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/rb_plugin2.png)", "description_content_type": "text/markdown", "docs_url": null, "download_url": "https://github.com/dopstar/ftransc/tarball/6.1.3", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/dopstar/ftransc", "keywords": "Audio,Convert,ffmpeg,avconv,mp3", "license": "", "maintainer": "", "maintainer_email": "", "name": "ftransc", "package_url": "https://pypi.org/project/ftransc/", "platform": "", "project_url": "https://pypi.org/project/ftransc/", "project_urls": { "Download": "https://github.com/dopstar/ftransc/tarball/6.1.3", "Homepage": "https://github.com/dopstar/ftransc" }, "release_url": "https://pypi.org/project/ftransc/6.1.3/", "requires_dist": null, "requires_python": "", "summary": "ftransc is a python library for converting audio files across various formats.", "version": "6.1.3" }, "last_serial": 4622650, "releases": { "6.0.0": [ { "comment_text": "", "digests": { "md5": "415d4b083a1397e885610938ee423045", "sha256": "df06e14d9ff374118d08d0032136a7283140b58062e3b8112370d25f5b30bca9" }, "downloads": -1, "filename": "ftransc-6.0.0.tar.gz", "has_sig": false, "md5_digest": "415d4b083a1397e885610938ee423045", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8219, "upload_time": "2016-08-01T18:01:45", "url": "https://files.pythonhosted.org/packages/98/8f/40c214fa34e15aef9b434371ccdaf517252203236f664457bab7e76fa638/ftransc-6.0.0.tar.gz" } ], "6.0.1": [ { "comment_text": "", "digests": { "md5": "c1022bf0a415a1f0ed69821760742d3c", "sha256": "68422e83496794fc558e9ef7bc43bf9fcf13b7a19de0deb53fd412932d5b3a24" }, "downloads": -1, "filename": "ftransc-6.0.1.tar.gz", "has_sig": false, "md5_digest": "c1022bf0a415a1f0ed69821760742d3c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8428, "upload_time": "2016-08-02T06:29:05", "url": "https://files.pythonhosted.org/packages/a3/67/16adb6fcf1e5a2378e23c8f4314ae4bb5abc73c4b30e58ed88b27dcb37b8/ftransc-6.0.1.tar.gz" } ], "6.0.10": [ { "comment_text": "", "digests": { "md5": "f77d736c6fef840a890d34df3d6efd30", "sha256": "1e54214c6a835a21515fb281fec9093ee5827b34850d693ed8c8b8c463ee07a8" }, "downloads": -1, "filename": "ftransc-6.0.10.tar.gz", "has_sig": false, "md5_digest": "f77d736c6fef840a890d34df3d6efd30", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9437, "upload_time": "2017-04-07T18:48:02", "url": "https://files.pythonhosted.org/packages/90/53/154e9720503fe3454d00cebb5b9c1960acf784089c70a4d8bc428d2a2ca8/ftransc-6.0.10.tar.gz" } ], "6.0.11": [ { "comment_text": "", "digests": { "md5": "d4b633ea99557a3c3ecdfac64825298f", "sha256": "27cde64f78ba89bc69472293e0336768d48a8fcb20ea5f88e55ff6f56f854d2d" }, "downloads": -1, "filename": "ftransc-6.0.11.tar.gz", "has_sig": false, "md5_digest": "d4b633ea99557a3c3ecdfac64825298f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9450, "upload_time": "2017-04-07T20:53:35", "url": "https://files.pythonhosted.org/packages/9f/9a/de16ea9f31d55c4e725faccfb92985bbc29e8648c247ce5c8ba3f27f8155/ftransc-6.0.11.tar.gz" } ], "6.0.2": [ { "comment_text": "", "digests": { "md5": "1f209ff3e2cc583de2a7cb29452545dc", "sha256": "7718499e87e3723a4a0518f9b942752bce4a37bda706331e22f177cb1f58a6bf" }, "downloads": -1, "filename": "ftransc-6.0.2.tar.gz", "has_sig": false, "md5_digest": "1f209ff3e2cc583de2a7cb29452545dc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8807, "upload_time": "2016-08-04T23:56:39", "url": "https://files.pythonhosted.org/packages/a5/6e/75ac1ae2a68bb09b9e06c7606c3b184eb12ec5ce6b63db29d33a194a5e3d/ftransc-6.0.2.tar.gz" } ], "6.0.3": [ { "comment_text": "", "digests": { "md5": "89131b41cab1185f52a09943ca71c93f", "sha256": "2691744ded750b1c7567def59a8696d73d25a3629d807fa8c20ccc93b5e7bb81" }, "downloads": -1, "filename": "ftransc-6.0.3.tar.gz", "has_sig": false, "md5_digest": "89131b41cab1185f52a09943ca71c93f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8828, "upload_time": "2016-11-17T18:39:32", "url": "https://files.pythonhosted.org/packages/b1/81/8a6699865998281449fd3a80c713629098d158be5c48c59ea1e33d26e17b/ftransc-6.0.3.tar.gz" } ], "6.0.4": [ { "comment_text": "", "digests": { "md5": "edc9cf23732b37eb961db9e060329076", "sha256": "d911f18b75fa3721df7138e9add78b00613e110ca76acbcda76f57dc9655482e" }, "downloads": -1, "filename": "ftransc-6.0.4.tar.gz", "has_sig": false, "md5_digest": "edc9cf23732b37eb961db9e060329076", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8847, "upload_time": "2016-11-17T18:43:30", "url": "https://files.pythonhosted.org/packages/a7/92/2ec55aba24405b39215b8a981d79f9060bc2564f7b42f02932740ab81755/ftransc-6.0.4.tar.gz" } ], "6.0.5": [ { "comment_text": "", "digests": { "md5": "66f9b6eed2c6f9f3ef540c59b6073fcf", "sha256": "0f4b06ccfdc4bf5198e738283291ff3a533825e0d738b62a51db2a4a97622ebc" }, "downloads": -1, "filename": "ftransc-6.0.5.tar.gz", "has_sig": false, "md5_digest": "66f9b6eed2c6f9f3ef540c59b6073fcf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8892, "upload_time": "2017-03-19T07:28:32", "url": "https://files.pythonhosted.org/packages/18/15/5bdf664d3f036d4b12012a03d12876bfbe176fe63192dca598b26ed3401d/ftransc-6.0.5.tar.gz" } ], "6.0.6": [ { "comment_text": "", "digests": { "md5": "a78e023e3e3e1861cacb0cbb8c8a3d2e", "sha256": "44fa9d030991ba0b05362e9442f1ba202147d151cac49d447afd2d2671dce285" }, "downloads": -1, "filename": "ftransc-6.0.6.tar.gz", "has_sig": false, "md5_digest": "a78e023e3e3e1861cacb0cbb8c8a3d2e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9175, "upload_time": "2017-04-05T21:03:59", "url": "https://files.pythonhosted.org/packages/d0/27/4aaf7282292494f4f74d4b68992ffbec60936e72684bfe9298e5db9fca68/ftransc-6.0.6.tar.gz" } ], "6.0.7": [ { "comment_text": "", "digests": { "md5": "dd019f1117f015449a4950eefb41909d", "sha256": "e11775a483191272a6ea1f48389692a98ee2136edb86a7aff4dbd3e51137353a" }, "downloads": -1, "filename": "ftransc-6.0.7.tar.gz", "has_sig": false, "md5_digest": "dd019f1117f015449a4950eefb41909d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10729, "upload_time": "2017-04-05T21:16:12", "url": "https://files.pythonhosted.org/packages/01/92/00d8c62ace1a20163f7eb7699df522bae281f9f2ad49bcbbf7f17f58767d/ftransc-6.0.7.tar.gz" } ], "6.0.8": [ { "comment_text": "", "digests": { "md5": "bbe97c6e18a63d9f3b524cc5277d2d3d", "sha256": "90a207eab540d247de2336e4b2b199a5e5d6f200294e4c2dd3d4062a07ef3318" }, "downloads": -1, "filename": "ftransc-6.0.8.tar.gz", "has_sig": false, "md5_digest": "bbe97c6e18a63d9f3b524cc5277d2d3d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9196, "upload_time": "2017-04-06T00:05:05", "url": "https://files.pythonhosted.org/packages/4c/d2/0f26df7f72ccabac35dd2aa94e20746f26ca856f10e775698dc38fde05ce/ftransc-6.0.8.tar.gz" } ], "6.0.9": [ { "comment_text": "", "digests": { "md5": "5f6ddba2f0e7fe6406e6af2ae23e8e09", "sha256": "86ccdbace2e5e6092f520ffc2d36f0ef7919f9d47c9ed7035659e734c580df3c" }, "downloads": -1, "filename": "ftransc-6.0.9.tar.gz", "has_sig": false, "md5_digest": "5f6ddba2f0e7fe6406e6af2ae23e8e09", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9398, "upload_time": "2017-04-07T09:50:26", "url": "https://files.pythonhosted.org/packages/7f/13/85e0570dc46b83db94e38a553c4fe823ef74bc0172c184f31359dc5f0346/ftransc-6.0.9.tar.gz" } ], "6.1.0": [ { "comment_text": "", "digests": { "md5": "58ad286d6362461acdc187651ea9e02e", "sha256": "f1abe368f0645cb5cf57e53451b5152cf9e3b30f40e37148f5297303404d44d6" }, "downloads": -1, "filename": "ftransc-6.1.0.tar.gz", "has_sig": false, "md5_digest": "58ad286d6362461acdc187651ea9e02e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9447, "upload_time": "2017-04-12T16:38:58", "url": "https://files.pythonhosted.org/packages/e3/3e/87291b1f17224aa532950c2e637f973561b79fb1c8d874ddfbb0e63de022/ftransc-6.1.0.tar.gz" } ], "6.1.1": [ { "comment_text": "", "digests": { "md5": "6071c6cb4b7a6fd92d79e3c258149f7b", "sha256": "d562063eef834d47e9446babc1590f099f9254fa46ce069e24b52aee1fbde289" }, "downloads": -1, "filename": "ftransc-6.1.1.tar.gz", "has_sig": false, "md5_digest": "6071c6cb4b7a6fd92d79e3c258149f7b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10888, "upload_time": "2018-03-10T13:22:18", "url": "https://files.pythonhosted.org/packages/09/61/ae4d2c007d52d932b3dcfe41e0ad2c47efb438be6aad292427a6d9fdd187/ftransc-6.1.1.tar.gz" } ], "6.1.3": [ { "comment_text": "", "digests": { "md5": "5b2d0eb2055f293b07b235b599965a86", "sha256": "6e6d13cb7375d1eb1ce8cc08fbf764dfb0df6d97b65c94e80a033f20dffe6886" }, "downloads": -1, "filename": "ftransc-6.1.3.tar.gz", "has_sig": false, "md5_digest": "5b2d0eb2055f293b07b235b599965a86", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11498, "upload_time": "2018-12-20T21:46:35", "url": "https://files.pythonhosted.org/packages/9d/b6/6c7d064f86f2976fd14625536f4814518f553e24f3bd952b1fe239c29dcf/ftransc-6.1.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5b2d0eb2055f293b07b235b599965a86", "sha256": "6e6d13cb7375d1eb1ce8cc08fbf764dfb0df6d97b65c94e80a033f20dffe6886" }, "downloads": -1, "filename": "ftransc-6.1.3.tar.gz", "has_sig": false, "md5_digest": "5b2d0eb2055f293b07b235b599965a86", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11498, "upload_time": "2018-12-20T21:46:35", "url": "https://files.pythonhosted.org/packages/9d/b6/6c7d064f86f2976fd14625536f4814518f553e24f3bd952b1fe239c29dcf/ftransc-6.1.3.tar.gz" } ] }