https://github.com/arkq/openaptx
Reverse-engineered apt-X audio codec
https://github.com/arkq/openaptx
aptx aptx-hd library reverse-engineering
Last synced: 19 days ago
JSON representation
Reverse-engineered apt-X audio codec
- Host: GitHub
- URL: https://github.com/arkq/openaptx
- Owner: arkq
- License: mit
- Created: 2017-11-01T10:31:14.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-17T23:19:25.000Z (about 3 years ago)
- Last Synced: 2024-07-02T20:45:19.848Z (over 1 year ago)
- Topics: aptx, aptx-hd, library, reverse-engineering
- Language: C
- Homepage:
- Size: 471 KB
- Stars: 134
- Watchers: 16
- Forks: 20
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# [open]aptx - reverse-engineered apt-X
This project is for research purposes only. Without a proper license private and commercial usage
might be a case of a patent infringement. If you are looking for a library, which can be installed
and used legally (commercial, private and educational usage), go to the Qualcomm® aptX™
[homepage](https://www.aptx.com/) and contact Qualcomm customer service.
The source code itself is licensed under the terms of the MIT license. However, compression
algorithms are patented and licensed under the terms of a proprietary license. Hence, compilation
and redistribution in a binary format is forbidden!
## Compilation
```sh
mkdir build && cd build
cmake -DENABLE_DOC=ON -DWITH_FFMPEG=ON -DWITH_SNDFILE=ON ..
make && make install
```
### Prerequisites
- CMake 3.22 or newer
- [Doxygen](https://doxygen.nl/index.html) (optional)
- [FFmpeg](https://ffmpeg.org/) 5.1.0 or newer (optional)
- [libfreeaptx](https://github.com/regularhunter/libfreeaptx) 0.1.0 or newer (optional)
- [libsndfile](https://libsndfile.github.io/libsndfile/) 1.0.19 or newer (optional)
```sh
# Install required packages on Debian-based systems
sudo apt-get install cmake doxygen ffmpeg libfreeaptx-dev libsndfile1-dev
```
### Configure options
- `ENABLE_DOC` - build and install manual files (requires Doxygen)
- `ENABLE_APTX_DECODER_API` - build with apt-X / apt-X HD decoder API (default: ON)
- `ENABLE_APTX_ENCODER_API` - build with apt-X / apt-X HD encoder API (default: ON)
- `ENABLE_APTX422` - build reverse engineered apt-X library based on `bt-aptX-x86-4.2.2.so`
- `ENABLE_APTXHD100` - build reverse engineered apt-X HD library based on `aptXHD-1.0.0-ARMv7A`
- `WITH_FFMPEG` - use FFmpeg as a back-end (otherwise, stub library will be built)
- `WITH_FREEAPTX` - use libfreeaptx as a back-end (FFmpeg back-end must be disabled)
- `WITH_SNDFILE` - read file formats supported by libsndfile (used by openaptx utils)
In the apt-X stub library (build without FFmpeg back-end), all symbols are exported as
[weak](https://en.wikipedia.org/wiki/Weak_symbol). As a consequence, it should be possible to
overwrite them during runtime with other library which exports strong symbols. However, it might
be required to define `LD_DYNAMIC_WEAK` environment variable - for more information consult
`ld.so` manual.
When reverse-engineered libraries were enabled, they will be automatically linked with the apt-X
stub library (build without FFmpeg back-end). See previous paragraph for the meaning of this.
## Benchmark
Below is the result of a small benchmark test performed with various apt-X encoding libraries.
Test was done with the usage of `aptxenc` and `aptxhdenc` tools from this repository.
Elapsed user time was calculated with the usage of a standard UNIX `time` command line tool. All
libraries (except original Qualcomm libraries) were compiled with Clang version 9.0.0 with the
`O3` optimization level.
### Setup
- CPU: ARM Cortex-A53
- Input file: WAV audio, Microsoft PCM, 16 bit, stereo 48000 Hz
- Input duration: 15 minutes 45 seconds
### Results
| Library | apt-X | Mbit/s | apt-X HD | Mbit/s |
|----------------------------------------|---------|---------|----------|---------|
| [libaptX-1.0.16-rel-Android21][1] | 1m01s | 23.8 | — | — |
| [libaptXHD-1.0.1-rel-Android21][1] | — | — | 1m04s | 22.7 |
| openaptx-stub | 0m11s | 0.0 | 0m11s | 0.0 |
| openaptx-ffmpeg (libavcodec-59.37.100) | 2m12s | 11.0 | 2m18s | 10.5 |
| aptx422 | 1m14s | 19.6 | — | — |
| aptxHD100 | — | — | 1m16s | 19.1 |
| [libopenaptx-0.2.0][2] | 1m17s | 18.8 | 1m19s | 18.4 |
[1]: archive/aarch64 "Archive with Qualcomm apt-X encoding libraries"
[2]: https://github.com/pali/libopenaptx "The apt-X encoder/decoder based on FFmpeg code"
## Resources
1. [AptX audio codec family](https://en.wikipedia.org/wiki/AptX)
1. [AptX encoder source code](https://android.googlesource.com/platform/packages/modules/Bluetooth/+/refs/heads/main/system/embdrv/encoder_for_aptx/)
1. [AptX HD encoder source code](https://android.googlesource.com/platform/packages/modules/Bluetooth/+/refs/heads/main/system/embdrv/decoder_for_aptxhd/)
1. [Method and apparatus for electrical signal coding](https://www.google.com/patents/EP0398973B1?cl=en)
1. [Two-channel QMF bank](https://www.hindawi.com/journals/isrn/2013/815619/)