# Membrane MP3 Lame plugin
[![Hex.pm](https://img.shields.io/hexpm/v/membrane_mp3_lame_plugin.svg)](https://hex.pm/package/membrane_mp3_lame_plugin)
[![CircleCI](https://circleci.com/gh/membraneframework/membrane_mp3_lame_plugin.svg?style=svg)](https://circleci.com/gh/membraneframework/membrane_mp3_lame_plugin)
The module contains element that encodes raw audio to MPEG-1 layer 3 format.
For now, only encoding audio with 2 channels, s32le format and 44100 sample rate is supported.
It is a part of [Membrane Multimedia Framework](https://membraneframework.org).
## Installation
Add the following line to your `deps` in `mix.exs`. Then, run `mix deps.get`.
```elixir
{:membrane_mp3_lame_plugin, "~> 0.18.2"}
```
This package depends on the [Lame encoder library](http://lame.sourceforge.net) library. The precompiled builds will be pulled and linked automatically. However, should there be any problems, consider installing it manually.
### MacOS
```bash
brew install lame
```
### Ubuntu
```bash
sudo apt-get install libmp3lame-dev
```
### Arch, Manjaro
```bash
sudo pacman -S lame
```
### Fedora
```bash
sudo dnf install lame-devel
```
## Usage
You can find an example in [`example.exs`](example.exs), where the `MP3.Lame.Encoder` element
was used in a pipeline that redirects audio from default input to an MP3 file.
To run the example, you can use the following command:
```bash
iex example.exs
```
## Copyright and License
Copyright 2020, [Software Mansion](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=membrane_mp3_lame_plugin)
[![Software Mansion](https://logo.swmansion.com/logo?color=white&variant=desktop&width=200&tag=membrane-github)](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=membrane_mp3_lame_plugin)
Licensed under the [Apache License, Version 2.0](LICENSE)