Metadata-Version: 2.1
Name: ftransc
Version: 7.0.3
Summary: ftransc is a python library for converting audio files across various formats.
Home-page: https://github.com/dopstar/ftransc
Author: Mkhanyisi Madlavana
Author-email: mkhanyisi@gmail.com
License: UNKNOWN
Download-URL: https://github.com/dopstar/ftransc/tarball/7.0.3
Description: [![Build Status](https://github.com/dopstar/ftransc/workflows/build/badge.svg?branch=master)](https://github.com/dopstar/ftransc/actions?query=workflow%3Abuild)
        [![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)
        [![Downloads](https://img.shields.io/pypi/dm/ftransc.svg)](https://pypi.python.org/pypi/ftransc)
        [![Licence](https://img.shields.io/github/license/dopstar/ftransc.svg)](https://raw.githubusercontent.com/dopstar/ftransc/master/LICENSE.txt)
        # What is ftransc
        
        `ftransc` is the python audio conversion library. It can convert local files or files from youtube (even youtube playlists).
        
        
        ## Installing ftransc
        
        
        ftransc can be installed as follows:
        
        ```
            pip install ftransc
        ```
        
        Then FFMpeg must also installed as follows:
        
        - On Linux based systems:
        ```
            sudo apt-get install ffmpeg lame flac vorbis-tools
        ```
        
        - On Mac OS X:
        ```
            brew install ffmpeg lame
        ```
        
        
        
        ## Examples 
        
        Example 1 - converting from MP3 to OGG:
        ```
            ftransc -f ogg filename.mp3
        ```
        The output file name for the above example will be 'filename.ogg'
        
        Example 2 - converting from MP3 to AAC, removing original file on success, using high quality preset:
        ```
            ftransc -r -q extreme -f aac filename.mp3
        ```
        
        Example 3 - extract audio content from a video files into the MP3 format, use best quality preset:
        ```
            ftransc -q insane -f mp3 filename2.avi filename3.mpg filename4.vob ...
        ```
        
        Example 4 - convert all audio files inside a given folder into WMA format. (This option is not recursive to child-folders)
        ```
            ftransc -f wma --directory /path/to/folder_name
        ```
        
        Example 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:
        ```
            find /path/to/folder_name -type f -print0 | xargs -0 ftransc -f aac -q high
        ```
        
        ## ftransc Quality Presets
        
        ftransc 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. 
        
        The `/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.
        
        
        ## ftransc Metadata Tags
        
        The 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:
        
        | *tag* | *m4a* | *mp3* | *ogg* | *flac* | *wma* | *mpc* | *wav* | *wv* |
        |-------|-------|-------|-------|--------|-------|-------|-------|------|
        | title | Y	| Y 	| Y 	| Y 	 | Y	 | Y 	 | N 	 | Y 	|
        | artist | Y | Y | Y | Y | Y | Y | N | Y |
        | album  | Y | Y | Y | Y | Y | Y | N | Y |
        | genre  | Y | Y | Y | Y | Y | Y | N | Y |
        | date   | Y | Y | Y | Y | Y | Y | N | Y |
        | tracknumber | Y | Y | Y | Y | Y | Y | N | Y |
        | composer    | Y | Y | Y | Y | Y | Y | N | N |
        | publisher   | N | Y | N | N | Y | N | N | N |
        | lyrics | Y | Y | N | N | Y | N | N | N |
        | album art   | Y | Y | N | Y | N | N | N | N |
        | album artist | N | N | N | N | N | N | N | N |
        | comment     | N | N | N | N | N | N | N | N |
        
        ______
        
        ## Screenshots
        
        The image below shows `ftransc` command in action on Terminal as well as the ftransc manpage (`man ftransc`):
        <!-- /static/images/ftransc_cli.png -->
        ![ftranansc_cli](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/ftransc_cli.png)
        
        _____
        
        ftransc GUI front-end, *ftransc_qt*:
        
        ![ftranansc_qt](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/ftransc_gui.png)
        
        _____
        
        ftransc also uses Nautilus Scripts, so you can right click selection of files and convert like:
        
        ![nautilus scripts](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/ftransc_nautilus-scripts.png)
        
        _____
        
        ### ftransc plugin for Rhythmbox media player:
        
        - The ftransc plugin for rhythmbox media player allows one to send files from Rhythmbox music player to ftransc for conversion.
        ![enabling plugin](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/rb_plugin0.png)
        
        ____
        
        - Enabling the plugin:
        ![enabling plugin](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/rb_plugin1.png)
        
        ____
        
        - Converting songs with ftransc from Rhythmbox
        ![using plugin](https://raw.githubusercontent.com/dopstar/ftransc/master/static/images/rb_plugin2.png)
        
        
        
Keywords: Audio,Convert,ffmpeg,avconv,mp3
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
