An audio decoding and manipulation library, with bindings for C, Python, and WebAssembly.
Project description
Babycat is an audio decoding and manipulation library
Features
Decoding, resampling, and encoding
Babycat's core feature set includes:
- decoding MP3, FLAC, and WAV.
- resampling audio to different frame rates.
- encoding waveforms to WAV.
Bindings for Rust, Python, WebAssembly, and C
Babycat can be used from the following target languages:
- Rust. The majority of Babycat is written in Rust, with the exception of a few C dependencies like libsamplerate.
- Python. Babycat's Python bindings allow you to decode, resample, and encode audio without being slowed down by Python's Global Interpreter Lock (GIL). Babycat also integrates with Jupyter, allowing you to play and listen to audio streams decoded by Babycat inside of a Jupyter notebook.
- WebAssembly. Babycat generates JavaScript/WebAssembly bindings that can run either in a web browser or in Node.js.
- C. Babycat exposes a C API, which is useful for both creating audio analysis projects in C or creating Babycat bindings for languages not mentioned above.
Effective multithreading and parallelism
Babycat is designed to parallelize the decoding of many audio files across multiple CPU cores. Babycat's Python bindings allow for parallel audio decoding without being slowed down by Python's Global Interpreter Lock.
Open source under the MIT license
The audio ecosystem is full of expensive proprietary software packages, or (L)GPL-licensed code that restricts how you can use it. In contrast, Babycat is licensed under the MIT license, allowing you to use Babycat any way you want for free.
Babycat is battle-tested in industry
Babycat was built at and is actively maintained by Neocrym, a record label that uses artificial intelligence to find and promote the world's greatest musicians. Neocrym uses Babycat to decode millions of songs as part of audio feature engineering pipelines for machine learning models.
Learn more
Source code and issues
You can find Babycat's source code at github.com/babycat-io/babycat.
API documentation and releases
babycat.io is our main documentation website. You can find documentation and releases for each binding at:
Binding | Documentation | Releases |
---|---|---|
Rust | docs.rs/babycat | crates.io/crates/babycat |
Python | babycat.io/api/python | pypi.org/project/babycat |
WebAssembly | babycat.io/api/wasm | npmjs.com/package/babycat |
C | babycat.io/api/c | No releases yet. You can compile from source. |
Tutorials
You can learn more about how to use Babycat from our long-form tutorials:
Acknowledgements
The first version of Babycat was an internal project at Neocrym written by Ritik Mishra Since then, the code has been extended and open-sourced by James Mishra.
Babycat is built on top of many high-quality open source packages, including:
- Symphonia for audio decoding.
- libsamplerate for high-quality audio resampling.
- Hound for WAV encoding.
- PyO3 for generating Python bindings.
- cbindgen for generating C bindings.
- wasm-bindgen for generating WebAssembly bindings.
Babycat's goal is to provide a simple and consistent API on top of the existing audio ecosystem, without sacrificing performance, portability, or permissive licensing.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Hashes for babycat-0.0.12-cp36-abi3-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a5f931e3afddc224a15ddb9fd360a6128dfb6a4873de602ed6f33dca607c776b |
|
MD5 | 60cdcf7dbc02c04a7dcea519595d8fb6 |
|
BLAKE2b-256 | c7d8dec5eaadffed6acfb4193bb50862c3ac293c96b55a0931583f84574cff4c |
Hashes for babycat-0.0.12-cp36-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5c9a630db4de75180c3c523583449172af24aef2ab6eccb83b0fb37d6a061a51 |
|
MD5 | f4711187d5dd5cffd8d7c7731b6190d1 |
|
BLAKE2b-256 | 61586bd2e587904364b4b3e6758e1dfc057c9f3457ab75c2dcaa20b4af03944b |
Hashes for babycat-0.0.12-cp36-abi3-macosx_10_7_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 672c263435a328ab711805d706022df8ca22e8dd796216927df4f01d55ac4e7f |
|
MD5 | ba2b315326d5b00f22c2e616f527f435 |
|
BLAKE2b-256 | 33a4514ff396e110dcac236749151e361cff29a8064b3a3c9ea67a23fcf6461e |