Skip to content

Commit a316b2b

Browse files
committed
DOC: Mention the lack of ASIO support and how to re-enable it
1 parent 86e6362 commit a316b2b

File tree

1 file changed

+16
-2
lines changed

1 file changed

+16
-2
lines changed

doc/installation.rst

+16-2
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,7 @@ If you want to try the very latest development version of the ``sounddevice`` mo
2525
have a look at the section about :doc:`CONTRIBUTING`.
2626

2727
If you install the ``sounddevice`` module with ``pip`` on macOS or Windows,
28-
the PortAudio_ library (with ASIO support on Windows) will be installed
29-
automagically.
28+
the PortAudio_ library will be installed automagically.
3029
On other platforms, you might have to install PortAudio with your package
3130
manager (the package might be called ``libportaudio2`` or similar).
3231

@@ -44,6 +43,21 @@ If needed -- and not installed already -- NumPy can be installed like this::
4443
python -m pip install numpy
4544

4645

46+
ASIO Support
47+
------------
48+
49+
Installing the ``sounddevice`` module with ``pip`` (on Windows)
50+
will provide PortAudio_ DLLs *without* ASIO support
51+
(because of the problems mentioned in `issue #496`__).
52+
To enable ASIO support, download the file
53+
`libportaudio64bit-asio.dll`__ or libportaudio32bit-asio.dll__
54+
and rename/move it as described in the next section.
55+
56+
__ https://github.com/spatialaudio/python-sounddevice/issues/496
57+
__ https://github.com/spatialaudio/portaudio-binaries/raw/master/libportaudio64bit-asio.dll
58+
__ https://github.com/spatialaudio/portaudio-binaries/raw/master/libportaudio32bit-asio.dll
59+
60+
4761
Custom PortAudio Library
4862
------------------------
4963

0 commit comments

Comments
 (0)