mirror of
https://github.com/gryf/flac2ogg.git
synced 2026-10-05 21:10:44 +02:00
85 lines
2.5 KiB
ReStructuredText
85 lines
2.5 KiB
ReStructuredText
flac2ogg
|
|
========
|
|
|
|
Flac2ogg is an automated Audio file converter.
|
|
|
|
At the beginning, aim of ``flac2ogg`` was to produce high quality *ogg* files
|
|
out of (preferably) lossless formats like *FLAC*/*WAVE*/*WavePack*. Over time
|
|
it evolved of ability to produce small-sized *mp3* files out of anything.
|
|
|
|
Of course there is no constraints on what source files would be and what output
|
|
format will be, so there is a possibility to create *ogg* form low quality
|
|
*mp3* files, nevertheless it doesn't make any sense :) This script automate
|
|
conversion between different type of audio formats.
|
|
|
|
Requirements
|
|
============
|
|
|
|
- python 3
|
|
- `mutagen`_ python library for tag read/write
|
|
- `vorbis tools`_ for ``ogg`` files encode/decode
|
|
- `opus tools`_ for ``opus`` files encode/decode
|
|
- `lame`_ for ``mp3`` files encode/decode
|
|
- `flac`_ for ``flac`` files decode
|
|
- `mac`_ for ``Monkey audio codecs``/``ape`` files decode
|
|
- `wavpack`_ for ``wavpack`` files decode
|
|
- `mplayer`_ for ``m4a`` files decode
|
|
- `shntool`_ and `cuetools`_ for splitting monolithic CD dump files
|
|
|
|
Supported formats
|
|
=================
|
|
|
|
Conversion can be performed from the following formats:
|
|
|
|
- FLAC
|
|
- MP3
|
|
- MP4
|
|
- WAVE
|
|
- WavePack
|
|
- Ape
|
|
- Ogg Vorbis
|
|
- Ogg Opus
|
|
|
|
Currently supported encoders:
|
|
|
|
- Ogg Vorbis
|
|
- Ogg Opus
|
|
- MP3 (lame)
|
|
|
|
There is an option to set the quality for the encoders - for *Vorbis* files
|
|
there would be used an ``-q`` option for ``oggenc`` command, for the *mp3*
|
|
format ``-V`` option would be used for ``lame`` command and ``--bitrate`` for
|
|
``opusenc`` for the *Opus* files. Consult corresponding encoder man pages for
|
|
details.
|
|
|
|
Usage
|
|
=====
|
|
|
|
Given that there are couple of music files, simplest usage is as follows:
|
|
|
|
.. code:: shell-session
|
|
|
|
$ flac2ogg.py directory_of_music_files/*
|
|
|
|
All files from that directory will be encoded to *opus* by default. If there
|
|
are already some *opus* files, new files would have ``_encoded_`` added into
|
|
the filename. Note, that output files will be placed next to the original
|
|
files.
|
|
|
|
License
|
|
=======
|
|
|
|
This work is licensed on 3-clause BSD license. See LICENSE file for details.
|
|
|
|
|
|
.. _mutagen: https://mutagen.readthedocs.io/en/latest/
|
|
.. _vorbis tools: http://www.vorbis.com/
|
|
.. _opus tools: https://opus-codec.org
|
|
.. _flac: http://www.vorbis.com/
|
|
.. _lame: http://lame.sourceforge.net/
|
|
.. _mac: http://www.deb-multimedia.org/dists/testing/main/binary-amd64/package/monkeys-audio.php
|
|
.. _wavpack: http://www.wavpack.com/
|
|
.. _mplayer: http://www.mplayerhq.hu/
|
|
.. _cuetools: https://github.com/svend/cuetools
|
|
.. _shntool: http://www.etree.org/shnutils/shntool/
|