Skip to content

Latest commit

 

History

History
39 lines (23 loc) · 1.54 KB

README.md

File metadata and controls

39 lines (23 loc) · 1.54 KB

NimBASS is a Nim wrapper for the BASS audio library.

NimBASS is distributed as a Nimble package and depends on nimterop to generate the wrappers. The BASS library and header files are downloaded using curl/powershell and extracted using unzip/powershell.

Installation

NimBASS can be installed via Nimble:

> nimble install nimbass

This will download, wrap and install NimBASS in the standard Nimble package location, typically ~/.nimble. Once installed, it can be imported into any Nim program.

Usage

Module documentation can be found here.

import strutils

import nimbass/bass
import nimbass/bass_fx

discard BASS_Init(cint(-1), cast[DWORD](44100), cast[DWORD](0), cast[DWORD](0), nil)

echo "Bass: " & $BASS_GetVersion().toHex()
echo "Bass FX: " & $BASS_FX_GetVersion().toHex()

NimBASS currently wraps BASS and BASS FX and dynamically links to the binaries that get copied to the application executable directory. At runtime, they are loaded with -rpath.

Credits

NimBASS wraps BASS and all licensing terms of BASS apply to the usage of this package.

Feedback

NimBASS is a work in progress and any feedback or suggestions are welcome. It is hosted on GitHub with an MIT license so issues, forks and PRs are most appreciated.