Clone this repo:
  1. e8a05a9 Merge pull request #21 from asymptotic-io/main by Antoine SOULIER · 3 weeks ago main upstream/main
  2. c212c30 meson: declare liblc3 as dependency by Taruntej Kanakamalla · 3 weeks ago
  3. 1669b25 fix: Remove use of deprecated `int` numpy attribute by Antoine Soulier · 5 weeks ago
  4. afb786c cosmetic: Warning may be used initialized with GCC 12.2 by Antoine Soulier · 5 weeks ago
  5. 22c2d39 feature: Make encoder/decoder states relocatable by Antoine Soulier · 5 weeks ago

Low Complexity Communication Codec (LC3)

The LC3 is an efficient low latency audio codec.

Low Complexity Communication Codec


The directory layout is as follows :

  • include: Library interface
  • src: Source files
  • tools: Standalone encoder/decoder tools
  • test: Python implentation, used as reference for unit testing
  • build: Building outputs
  • bin: Compilation output

How to build

The default toolchain used is GCC. Invoke make to build the library.

$ make -j

Compiled library liblc3.a will be found in bin directory.

Cross compilation

The cc, as, ld and ar can be selected with respective Makefile variables CC, AS, LD and AR. The AS and LD selections are optionnal, and fallback to CC selection when not defined.

The LIBC must be set to bionic for android cross-compilation. This switch prevent link with pthread and rt libraries, that is included in the bionic libc.

Following example build for android, using NDK toolset.

$ make -j CC=path_to_android_ndk_prebuilt/toolchain-prefix-clang LIBC=bionic

Compiled library will be found in bin directory.


Tools can be all compiled, while involking make as follows :

$ make tools

The standalone encoder elc3 take a wave file as input and encode it according given parameter. The LC3 binary file format used is the non standard format described by the reference encoder / decoder tools. The standalone decoder dlc3 do the inverse operation.

Refer to elc3 -h or dlc3 -h for options.

Note that elc3 output bitstream to standard output when output file is omitted. On the other side dlc3 read from standard input when input output file are omitted. In such way you can easly test encoding / decoding loop with :

$ ./elc3 <in.wav> -b <bitrate> | ./dlc3 > <out.wav>

Adding Linux aplay tools, you will be able to instant hear the result :

$ ./elc3 <in.wav> -b <bitrate> | ./dlc3 | aplay


A python implementation of the encoder is provided in test diretory. The C implementation is unitary validated against this implementation and intermediate values given in Appendix C of the specification.


# apt install python3 python3-dev python3-pip
$ pip3 install scipy numpy

Running test suite

$ make test


The proposed encoder and decoder implementation have been fully tested and validated.

For more detail on conformance, refer to Bluetooth Conformance Documents and scripts

Listening Test

The codec was here subjectively evaluated in a blind listening test.

Meson build system

Meson build system is also available to build and install lc3 codec in Linux environment.

$ meson build
$ cd build
$ ninja
$ sudo ninja install