Pythonic Audio Library and Codecs Environment https://mcsinyx.github.io/palace
Go to file
Nguyễn Gia Phong 5ec6aa5ede Fix Source's 3D spatialization setter logic
Also correct some doc and pump version to 0.0.2
2020-01-09 21:03:08 +07:00
examples Nitpick packaging and examples 2020-01-08 20:44:07 +07:00
.gitignore Prove the concept by the first few examples 2019-12-22 16:26:51 +07:00
LICENSE Initial commit 2019-12-22 14:42:53 +07:00
MANIFEST.in Nitpick packaging and examples 2020-01-08 20:44:07 +07:00
README.md s/archaicy/palace/g 2020-01-04 11:55:49 +07:00
alure.pxd s/archaicy/palace/g 2020-01-04 11:55:49 +07:00
palace.pyx Fix Source's 3D spatialization setter logic 2020-01-09 21:03:08 +07:00
pyproject.toml Nitpick packaging and examples 2020-01-08 20:44:07 +07:00
setup.py Fix Source's 3D spatialization setter logic 2020-01-09 21:03:08 +07:00
tox.ini Nitpick packaging and examples 2020-01-08 20:44:07 +07:00

README.md

palace

Palace is a Python 3D audio API wrapping around alure. To quote alure's README,

It uses OpenAL for audio rendering, and provides common higher-level features such as file loading and decoding, buffer caching, background streaming, and source management for virtually unlimited sound source handles.

Features

In some sense, what palace aimes to be to OpenAL is what ModernGL is to OpenGL (except that all the heavy-lifting are taken are by alure):

  • 3D sound rendering
  • Environmental audio effects: reverb, atmospheric air absorption, sound occlusion and obstruction
  • Binaural (HRTF) rendering
  • Out-of-the-box audio decoding of FLAC, MP3, Ogg Vorbis, Opus, WAV, AIFF, etc.
  • Modern Pythonic API: snake_case, @property, with context manager, type annotation

Installation

Via PyPI

Palace requires Python 3.6+ and alure. Given these dependencies satisfied, palace could be installed using pip via

pip install palace

Currently only GNU/Linux is supported. If you want to help package for other operating systems, please head to issue #1.

From source

To build from source, one will also need to have Python headers, Cython, and a C++11 compiler (and probably git for fetching the source) installed. Palace can then be compiled and installed by running

git clone https://github.com/McSinyx/palace
cd palace
python setup.py install --user

Usage

One may start with the examples for sample usage of palace. For further information, Python's help is your friend.