# java-lame

**Repository Path**: tiny_prawn/java-lame

## Basic Information

- **Project Name**: java-lame
- **Description**: No description available
- **Primary Language**: Java
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-10-29
- **Last Updated**: 2022-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Java LAME
This java port of LAME 3.98.4 was created by Ken Händel for his 'jump3r - Java Unofficial MP3 EncodeR' project:
http://sourceforge.net/projects/jsidplay2/

Original sources by the authors of LAME: http://www.sourceforge.net/projects/lame

The code is - as the original - licensed under the LGPL (see LICENSE).

## How to build 

To create a jar file, you may start the gradle build process with the included gradle wrapper:

    $ ./gradlew jar
    
The resulting library is then to be found in the following directory:

    ./build/libs/
    
You can find an already built Jar file in the releases: https://github.com/nwaldispuehl/java-lame/releases

## How to run

After having created a jar file, you certainly can run it as a command line application:

    $ cd /build/libs
    $ java -jar net.sourceforge.lame-3.98.4.jar

## How to run the test

To see the creation of a MP3 file in action one can run the test class `LameEncoderTest.java`:

    $ ./gradlew check
    
It takes the `src/test/resources/test.wav` file as input and writes the converted data into `build/test.mp3`.


## How to use Java LAME in a project?

### WAV/PCM to MP3

To convert a WAV/PCM byte array to an MP3 byte array, you may use Ken Händels ```LameEncoder``` which offers the 
following convenience method for converting chunks of such byte buffer:

```
LameEncoder#encodeBuffer(final byte[] pcm, final int pcmOffset, final int pcmLength, final byte[] encoded)
```

A sample of its use can be found in the `LameEncoderTest.java`:
https://github.com/nwaldispuehl/java-lame/blob/master/src/test/java/net/sourceforge/lame/lowlevel/LameEncoderTest.java

### MP3 to WAV/PCM

Analog for decoding; the following method allows for easy conversion of a MP3 file into a PCM byte array:

```
LameDecoder#decode(final ByteBuffer sampleBuffer)
```

A sample of its use can be found in the `LameDecoderTest.java`:
https://github.com/nwaldispuehl/java-lame/blob/master/src/test/java/net/sourceforge/lame/lowlevel/LameDecoderTest.java


### Credits

Test sound 'Jingle004' (CC BY-NC 3.0) by 'cydon': https://freesound.org/people/cydon/sounds/133054/