Skip to main content

ftransc is a python library for converting audio files across various formats.

Project description

Build Status Python Version PyPI Status Downloads Licence

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):

ftranansc_cli


ftransc GUI front-end, ftransc_qt:

ftranansc_qt


ftransc also uses Nautilus Scripts, so you can right click selection of files and convert like:

nautilus scripts


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

  • Enabling the plugin: enabling plugin

  • Converting songs with ftransc from Rhythmbox using plugin

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ftransc-7.0.3.tar.gz (13.7 kB view details)

Uploaded Source

Built Distribution

ftransc-7.0.3-py2.py3-none-any.whl (22.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file ftransc-7.0.3.tar.gz.

File metadata

  • Download URL: ftransc-7.0.3.tar.gz
  • Upload date:
  • Size: 13.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.7.1

File hashes

Hashes for ftransc-7.0.3.tar.gz
Algorithm Hash digest
SHA256 54ac4d52b8f10c46f76a8177c82292d440bdd381fa65fcbc4e1eb899cc420c77
MD5 8434c8f6479b264d2c5db9e4f4faaad4
BLAKE2b-256 396e0f31ca42eb5965909bba9f393f28e9093e94e6219b16db1496fe3a0414a4

See more details on using hashes here.

File details

Details for the file ftransc-7.0.3-py2.py3-none-any.whl.

File metadata

  • Download URL: ftransc-7.0.3-py2.py3-none-any.whl
  • Upload date:
  • Size: 22.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.8.7

File hashes

Hashes for ftransc-7.0.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 05e29f696675da1adbd8ad79d3ba248eb5bdb06c0c55444ac5358269fc9f491d
MD5 e2a388e7330787bb2ade79bb96fda00d
BLAKE2b-256 41b7a14a35ddff678a1bfacf64fd2cf122ac0715574518f784be842d06ae1b53

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page