Skip to main content

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

Release files for ftransc 7.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ftransc 7.0.3
File Size Uploaded
ftransc-7.0.3.tar.gz 13.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ftransc 7.0.3
File Interpreter ABI Platform
ftransc-7.0.3-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 35.9 kB

Release files / ftransc-7.0.3.tar.gz

Download URL ftransc-7.0.3.tar.gz
Size 13.7 kB
Tags Source
SHA-256 checksum
How to use checksums
54ac4d52b8f10c46f76a8177c82292d440bdd381fa65fcbc4e1eb899cc420c77
BLAKE2b-256 checksum
How to use checksums
396e0f31ca42eb5965909bba9f393f28e9093e94e6219b16db1496fe3a0414a4
Upload date
Uploaded using Trusted Publishing?
What is 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

Release files / ftransc-7.0.3-py2.py3-none-any.whl

Download URL ftransc-7.0.3-py2.py3-none-any.whl
Size 22.2 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
05e29f696675da1adbd8ad79d3ba248eb5bdb06c0c55444ac5358269fc9f491d
BLAKE2b-256 checksum
How to use checksums
41b7a14a35ddff678a1bfacf64fd2cf122ac0715574518f784be842d06ae1b53
Upload date
Uploaded using Trusted Publishing?
What is 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

Release history Release notifications | RSS feed

This release

7.0.3 This release

2 release files

7.0.2

1 release file

7.0.1

1 release file

7.0.0

1 release file

6.1.3

1 release file

6.1.1

1 release file

6.1.0

1 release file

6.0.11

1 release file

6.0.10

1 release file

6.0.9

1 release file

6.0.8

1 release file

6.0.7

1 release file

6.0.6

1 release file

6.0.5

1 release file

6.0.4

1 release file

6.0.3

1 release file

6.0.2

1 release file

6.0.1

1 release file

6.0.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page