xPlay

Simple audio playing/recording example application.

Usage: example [options]

.. code-block:: bash --help Print usage and exit

--version Print version

--listDevices, -l Print available audio devices and exit

--playfile, -p Play audio from file 

--plugin, -g Load plugin from file 

--recordfile, -R Record audio to file 

--samplerate, -r Set Sample Rate to 

--bitresolution, -b Set recording sample resolution bits

--playtone, -t Play tone of freq 

--recchancount, -c Sets number of record channels to 

--device, -d Use device number    

Examples

.. code-block:: bash
    xplay --playtone 1000

    xplay --playfile file.wav

    xplay --playfile play.wav --recordfile record.wav

    xplay -R test.wav -d 2 -c 2

Dependancies
------------

 * libsndfile (http://www.mega-nerd.com/libsndfile/#Download)
 * portaudio (http://www.portaudio.com)
 * ASIO SDK (http://www.steinberg.net/en/company/developers.html)

Note that in order to build against newer OS X SDKs such as 10.11, you will probably need a development version of PortAudio. These are named "rc" and dated 2016 on PortAudio website, whereas the older stable releases dated 2014 only go up to OS X 10.9.

Building
--------

A *simple* makefile is provided. It expects a sandbox with the following directory structure:

 - xplay (this repo)
 - portaudio (port audio source)
 - asiosdk (ASIO SDK files)
 - libsndfile (libsndfile source)

Mac

• Install xcode command line tools
• In xplay/xplay run "make all"

Windows

The xplay source code uses C11 threads (uses features:  thread creation and management, mutex and conditional variables). One way of supporting this on Windows is as follows:

   * Download and install MSYS2 (msys2.github.io)
   * Open an MSYS2 command prompt (or the 32-bit or 64-bit command prompts if you plan on building 32-bit or 64-bit things) from the start menu entries
   * Install make (pacman -S make)
   * Install a toolchain e.g:
      - pacman -S mingw-w64-i686-gcc
   * Move into xplay/xplay and use the command
      - make all

Note, if GCC isn't found, you probably are not running the  correct command prompt  for the tools you installed

Plugins
-------

A *simple* plugin system is available to quickly add audio processing.

A plugin should be compiled as follows:

g++ -shared -o plugin.so plugin_source.cpp

It can be passed to xplay using the --plugin option.

See ./plugins for examples.