{"id":18803403,"url":"https://github.com/dopstar/ftransc","last_synced_at":"2025-04-13T18:34:29.928Z","repository":{"id":13147103,"uuid":"15829562","full_name":"dopstar/ftransc","owner":"dopstar","description":"The Audio Converter","archived":false,"fork":false,"pushed_at":"2021-08-02T14:43:58.000Z","size":1975,"stargazers_count":17,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-27T09:12:49.292Z","etag":null,"topics":["audio-library","conversion","extract","ftransc","mp3","ogg","python-library","youtube"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/ftransc","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dopstar.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-01-11T19:56:34.000Z","updated_at":"2025-03-01T13:57:09.000Z","dependencies_parsed_at":"2022-08-25T20:21:47.747Z","dependency_job_id":null,"html_url":"https://github.com/dopstar/ftransc","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dopstar%2Fftransc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dopstar%2Fftransc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dopstar%2Fftransc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dopstar%2Fftransc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dopstar","download_url":"https://codeload.github.com/dopstar/ftransc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248317720,"owners_count":21083528,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio-library","conversion","extract","ftransc","mp3","ogg","python-library","youtube"],"created_at":"2024-11-07T22:35:02.730Z","updated_at":"2025-04-13T18:34:29.903Z","avatar_url":"https://github.com/dopstar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://github.com/dopstar/ftransc/workflows/build/badge.svg?branch=master)](https://github.com/dopstar/ftransc/actions?query=workflow%3Abuild)\n[![Python Version](https://img.shields.io/pypi/pyversions/ftransc.svg)](https://pypi.python.org/pypi/ftransc) \n[![PyPI Status](https://img.shields.io/pypi/v/ftransc.svg)](https://pypi.python.org/pypi/ftransc)\n[![Downloads](https://img.shields.io/pypi/dm/ftransc.svg)](https://pypi.python.org/pypi/ftransc)\n[![Licence](https://img.shields.io/github/license/dopstar/ftransc.svg)](https://raw.githubusercontent.com/dopstar/ftransc/master/LICENSE.txt)\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\u003c!-- /static/images/ftransc_cli.png --\u003e\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)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdopstar%2Fftransc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdopstar%2Fftransc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdopstar%2Fftransc/lists"}