Skip to content
MP3 codec for Julia using JuliaAudio idioms. LAME and mpg123 working under the hood
Julia
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
deps
src
test
.gitignore
.travis.yml
LICENSE.md MP3.jl generated files. Jun 9, 2016
README.md
REQUIRE use 0.6.0-pre as minimum julia version in REQUIRE May 25, 2017
appveyor.yml

README.md

MP3

Build Status Build status codecov.io

MP3 is a Julia library for reading and writing MP3 files.

Usage

The API follows the idioms of FileIO, and uses SampleBuf type to store audio samples. This should supplement LibSndFile which does not support MP3 for patent issues.

Loading MP3

julia> using MP3

julia> audio = load("Sour_Tennessee_Red_Sting.mp3")
245376-frame, 2-channel SampleBuf{FixedPointNumbers.Fixed{Int16,15}, 2, SIUnits.SIQuantity{Int64,0,0,-1,0,0,0,0,0,0}}
5.564081632653061 s at 44100 s⁻¹
▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▆▆▆▇▇▇▇▆▆▅▄▄▄▄▄▄▇▇▇▇▇▆▇▇▇▇▇▆▅▅▄▄▃▃▃▃▃▂▂▂▁▂▁▁▁
▇▇▇▆▇▇▇▆▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▇▆▆▅▇▇▆▆▆▅▅▄▄▄▅▄▃▇▇▇▇▇▆▇▇▇▇▆▆▅▄▄▄▄▃▃▃▃▂▂▂▁▂▁▁▁

Saving MP3

Various options for encoding MP3 files can be specified using keyword arguments to save() function. An ID3v2 block will be added in front of the file, and the following tags can be optionally given as keyword arguments: title, artist, album, year, comment.

julia> save("mono.mp3", audio; nchannels = 1)           # save as mono audio

julia> save("small.mp3", audio; bitrate = 128)          # set bitrate to 128kbps

julia> save("vbr.mp3", audio; VBR = true, quality = 0)  # encode as highest-quality VBR

julia> save("down.mp3", audio; samplerate = 8kHz)       # downsample to 8 kHz

License

This Julia library is distributed under MIT license. It uses LAME for encoding and mpg123 for decoding mp3, which are dynamically linked, binding to the terms of their LGPL.

You can’t perform that action at this time.