lame-0.2.0: README.md

# LAME for Haskell

[![License BSD3](https://img.shields.io/badge/license-BSD3-brightgreen.svg)](http://opensource.org/licenses/BSD-3-Clause)
[![Hackage](https://img.shields.io/hackage/v/lame.svg?style=flat)](https://hackage.haskell.org/package/lame)
[![Stackage Nightly](http://stackage.org/package/lame/badge/nightly)](http://stackage.org/nightly/package/lame)
[![Stackage LTS](http://stackage.org/package/lame/badge/lts)](http://stackage.org/lts/package/lame)
[![Build Status](https://travis-ci.org/mrkkrp/lame.svg?branch=master)](https://travis-ci.org/mrkkrp/lame)

This is a fairly complete high-level Haskell binding to
[LAME](http://lame.sourceforge.net/).

## Provided functionality

* Fast MP3 encoder working in various modes (you specify compression ratio,
  desired bit-rate, or parameters for VBR), with quite a few interesting
  options to tweak.
* Setting of all common tags, including pictures.

## Limitations

* No decoding for now. It's actually done via a separate library in LAME.
* Relatively limited (compared
  to [ID3 specs](http://id3.org/id3v2.3.0#Text_information_frames)) number
  of tag fields available for setting.
* Some sample widths are not supported: less than or equal to 8 bit and
  greater than 16 bits (for integer samples, floats work OK).
* Some psycho-acoustic and noise-shaping settings are not available for
  tweaking.

Open an issue if something of this is a deal breaker for you, some of these
limitations are easily lifted.

## Contribution

Please kindly direct all issues, bugs, and questions to [the GitHub issue
tracker for this project](https://github.com/mrkkrp/lame/issues).

## License

Copyright © 2017–2019 Mark Karpov

Distributed under BSD 3 clause license.