Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dh1tw/Gosamplerate

Go Bindings for libsamplerate
https://github.com/dh1tw/Gosamplerate

audio audio-library audio-processing golang libsamplerate

Last synced: 20 days ago
JSON representation

Go Bindings for libsamplerate

Host: GitHub
URL: https://github.com/dh1tw/Gosamplerate
Owner: dh1tw
License: bsd-2-clause
Created: 2016-11-20T21:19:31.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2024-01-28T01:50:34.000Z (10 months ago)
Last Synced: 2024-07-31T01:22:32.202Z (4 months ago)
Topics: audio, audio-library, audio-processing, golang, libsamplerate
Language: Go
Size: 425 KB
Stars: 34
Watchers: 1
Forks: 11
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # libsamplerate binding for Golang

[![Go Report Card](https://goreportcard.com/badge/github.com/dh1tw/gosamplerate)](https://goreportcard.com/report/github.com/dh1tw/gosamplerate)

[![Cross Platform build](https://github.com/dh1tw/gosamplerate/actions/workflows/build.yml/badge.svg)](https://github.com/dh1tw/gosamplerate/actions/workflows/build.yml)

[![codecov](https://codecov.io/gh/dh1tw/gosamplerate/graph/badge.svg?token=5vIJOLA5hI)](https://codecov.io/gh/dh1tw/gosamplerate)

This is a [Golang](https://golang.org) binding for [libsamplerate](http://www.mega-nerd.com/SRC/index.html) (written in C), probably the best audio Sample Rate Converter available to today.

A classical use case is converting audio from a CD sample rate of 44.1kHz to the 48kHz sample rate used by DAT players.

libsamplerate is capable of arbitrary and time varying conversions (max sampling / upsampling by factor 256) and comes with 5 converters, allowing quality to be traded off against computation cost.

## API implementations

**gosamplerate** implements the following [libsamplerate](http://www.mega-nerd.com/SRC/index.html) API calls:

- [Simple API](http://www.mega-nerd.com/SRC/api_simple.html)

- [Full API](http://www.mega-nerd.com/SRC/api_full.html)

- [Most miscellaneous functions](http://www.mega-nerd.com/SRC/api_misc.html)

not (yet) implemented is:

- [Callback API](http://www.mega-nerd.com/SRC/api_callback.html)

## License

This library (**gosamplerate**) is published under the the permissive [BSD license](http://choosealicense.com/licenses/mit/). You can find a good comparison of Open Source Software licenses, including the BSD license at [choosealicense.com](http://choosealicense.com/licenses/)

libsamplerate has been [republished in 2016 under the 2-clause BSD license](http://www.mega-nerd.com/SRC/license.html).

## How to install samplerate

Make sure that you have [libsamplerate](http://www.mega-nerd.com/SRC/index.html) installed on your system.

On Mac or Linux it can be installed conveniently through your distro's packet manager.

### Linux:

using **apt** (Ubuntu), **yum** (Centos)...etc.

```bash

    $ sudo apt install libsamplerate0

```

### MacOS

using [Homebrew](http://brew.sh):

```bash

    $ brew install libsamplerate

```

### Install gosamplerate

```bash

    $ go get github.com/dh1tw/gosamplerate

```

## Documentation

The API of **gosamplerate** can be found at [godoc.org](https://godoc.org/github.com/dh1tw/gosamplerate).

The documentation of libsamplerate (necessary in order to fully understand the API) can be found

[here](http://www.mega-nerd.com/SRC/index.html).

## Tests & Examples

The test coverage is close to 100%. The tests contain various examples on how to use **gosamplerate**.