forked from pool/python-SoundCard
high-level cross-platform audio toolkit for Python
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-SoundCard?expand=0&rev=1
This commit is contained in:
Todd R
Git OBS Bridge
23
.gitattributes
vendored
Normal file
23
.gitattributes
vendored
Normal file
@@ -0,0 +1,23 @@
|
||||
## Default LFS
|
||||
*.7z filter=lfs diff=lfs merge=lfs -text
|
||||
*.bsp filter=lfs diff=lfs merge=lfs -text
|
||||
*.bz2 filter=lfs diff=lfs merge=lfs -text
|
||||
*.gem filter=lfs diff=lfs merge=lfs -text
|
||||
*.gz filter=lfs diff=lfs merge=lfs -text
|
||||
*.jar filter=lfs diff=lfs merge=lfs -text
|
||||
*.lz filter=lfs diff=lfs merge=lfs -text
|
||||
*.lzma filter=lfs diff=lfs merge=lfs -text
|
||||
*.obscpio filter=lfs diff=lfs merge=lfs -text
|
||||
*.oxt filter=lfs diff=lfs merge=lfs -text
|
||||
*.pdf filter=lfs diff=lfs merge=lfs -text
|
||||
*.png filter=lfs diff=lfs merge=lfs -text
|
||||
*.rpm filter=lfs diff=lfs merge=lfs -text
|
||||
*.tbz filter=lfs diff=lfs merge=lfs -text
|
||||
*.tbz2 filter=lfs diff=lfs merge=lfs -text
|
||||
*.tgz filter=lfs diff=lfs merge=lfs -text
|
||||
*.ttf filter=lfs diff=lfs merge=lfs -text
|
||||
*.txz filter=lfs diff=lfs merge=lfs -text
|
||||
*.whl filter=lfs diff=lfs merge=lfs -text
|
||||
*.xz filter=lfs diff=lfs merge=lfs -text
|
||||
*.zip filter=lfs diff=lfs merge=lfs -text
|
||||
*.zst filter=lfs diff=lfs merge=lfs -text
|
||||
1
.gitignore
vendored
Normal file
1
.gitignore
vendored
Normal file
@@ -0,0 +1 @@
|
||||
.osc
|
||||
111
README.md
Normal file
111
README.md
Normal file
@@ -0,0 +1,111 @@
|
||||
# SoundCard
|
||||
|
||||
SoundCard is a library for playing and recording audio without resorting to a CPython extension. Instead, it is implemented using the wonderful [CFFI](http://cffi.readthedocs.io/en/latest/) and the native audio libraries of Linux, Windows and macOS.
|
||||
|
||||
SoundCard is cross-platform, and supports Linux/pulseaudio, Mac/coreaudio, and Windows/WASAPI. While the interface is identical across platforms, naming schemes and block sizes can vary between devices and platforms.
|
||||
|
||||
SoundCard is still very early in its development. All major building blocks are in place, but I fully expect there to be bugs and possibly crashes. If you find a bug, please open an Issue, and I will try to fix it. Or open a Pull Request, and I will try to include your fix into SoundCard.
|
||||
|
||||
However, please be aware that this is a hobby project of mine that I am developing for free, and in my spare time. While I try to be as accomodating as possible, I can not guarantee a timely response to issues. Publishing Open Source Software on Github does not imply an obligation to *fix your problem right now*. Please be civil.
|
||||
|
||||
## Tutorial
|
||||
|
||||
Here is how you get to your Speakers and Microphones:
|
||||
|
||||
```python
|
||||
import soundcard as sc
|
||||
|
||||
speakers = sc.all_speakers()
|
||||
default_speaker = sc.default_speaker()
|
||||
mics = sc.all_microphones()
|
||||
default_mic = sc.default_microphone()
|
||||
# search by substring:
|
||||
one_speaker = sc.get_speaker('Scarlett')
|
||||
one_mic = sc.get_microphone('Scarlett')
|
||||
# fuzzy-search:
|
||||
one_speaker = sc.get_speaker('FS2i2')
|
||||
one_mic = sc.get_microphone('FS2i2')
|
||||
```
|
||||
|
||||
All of these functions return `Speaker` and `Microphone` objects, which can be used for playback and recording. All data passed in and out of these objects are *frames × channels* Numpy arrays.
|
||||
|
||||
```python
|
||||
import numpy
|
||||
|
||||
print(default_speaker)
|
||||
>>> <Speaker alsa_output.usb-Focuswrite_Scarlett_2i2_USB-00-USB.analog-stereo (2 channels)>
|
||||
print(default_mic)
|
||||
>>> <Microphone alsa_input.usb-Focuswrite_Scarlett_2i2_USB-00-USB.analog-stereo (2 channels)>
|
||||
|
||||
# record and play back one second of audio:
|
||||
data = default_mic.record(samplerate=44100, numframes=44100)
|
||||
default_speaker.play(data/numpy.max(data), samplerate=44100)
|
||||
|
||||
# alternatively, get a `recorder` and `player` object and play or record continuously:
|
||||
with default_mic.recorder(samplerate=44100) as mic, default_speaker.player(samplerate=44100) as sp:
|
||||
for _ in range(100):
|
||||
data = mic.record(numframes=1024)
|
||||
sp.play(data)
|
||||
```
|
||||
|
||||
## Channel Maps
|
||||
|
||||
Some professional sound cards have large numbers of channels. If you want to record or play only a subset of those channels, you can specify a channel map. For playback, a channel map of `[0, 3, 4]` will play three-channel audio data on the physical channels one, four, and five. For recording, a channel map of `[0, 3, 4]` will return three-channel audio data recorded from the physical channels one, four, and five.
|
||||
|
||||
Currently, channel maps do not work on Windows (beyond reordering). The API does not seem to support it. If you know how to implement channel maps on Windows, I'd be grateful for a hint!
|
||||
|
||||
In addition, pulseaudio/Linux defines channel `-1` as the mono mix of all channels for both playback and recording. CoreAudio/macOS defines channel `-1` as silence for both playback and recording.
|
||||
|
||||
## Known Issues:
|
||||
|
||||
* Windows/WASAPI currently records garbage if you record only a single channel. Multi-channel and channel maps work, though.
|
||||
* Error messages often report some internal CFFI/backend errors. This will be improved in the future.
|
||||
* Documentation is not great yet. This will be improved in the future.
|
||||
* Windows/WASAPI silently ignores the blocksize. The reason for this is still unknown.
|
||||
|
||||
## Changelog
|
||||
|
||||
- 2018-04-25 implements fixed block sizes when recording
|
||||
(thank you, Pariente Manuel!)
|
||||
- 2018-05-10 adds a test suite and various fixes for Windows
|
||||
- 2018-05-11 various fixes for macOS
|
||||
- 2018-09-22 adds loopback support on Windows
|
||||
(thank you, Jan Leskovec!)
|
||||
- 2018-09-23 renames `exclude_monitors` to `include_loopback`
|
||||
(thank you, Jan Leskovec!)
|
||||
- 2018-10-07 adds workaround if COM was already initialized on Windows
|
||||
(thank you, Sebastian Michel!)
|
||||
- 2018-10-16 fixes blockless recording on Linux
|
||||
|
||||
## License
|
||||
|
||||
Copyright (c) 2016 Bastian Bechtold
|
||||
All rights reserved.
|
||||
|
||||
Redistribution and use in source and binary forms, with or without
|
||||
modification, are permitted provided that the following conditions are
|
||||
met:
|
||||
|
||||
1. Redistributions of source code must retain the above copyright
|
||||
notice, this list of conditions and the following disclaimer.
|
||||
|
||||
2. Redistributions in binary form must reproduce the above copyright
|
||||
notice, this list of conditions and the following disclaimer in the
|
||||
documentation and/or other materials provided with the
|
||||
distribution.
|
||||
|
||||
3. Neither the name of the copyright holder nor the names of its
|
||||
contributors may be used to endorse or promote products derived
|
||||
from this software without specific prior written permission.
|
||||
|
||||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||||
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||||
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
||||
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
||||
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
||||
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
||||
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
||||
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
||||
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||||
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||||
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
3
SoundCard-0.2.0-py3-none-any.whl
Normal file
3
SoundCard-0.2.0-py3-none-any.whl
Normal file
@@ -0,0 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:ed837994cb51bfaf1c2d9d9a0428730d5319e454e5fe6f3197fa5dbd02e2bb6c
|
||||
size 32440
|
||||
1
python-SoundCard-rpmlintrc
Normal file
1
python-SoundCard-rpmlintrc
Normal file
@@ -0,0 +1 @@
|
||||
addFilter("devel-file-in-non-devel-package .*/site-packages/soundcard/.*.py.h")
|
||||
4
python-SoundCard.changes
Normal file
4
python-SoundCard.changes
Normal file
@@ -0,0 +1,4 @@
|
||||
-------------------------------------------------------------------
|
||||
Wed Oct 31 05:02:27 UTC 2018 - Todd R <toddrme2178@gmail.com>
|
||||
|
||||
- Initial version
|
||||
83
python-SoundCard.spec
Normal file
83
python-SoundCard.spec
Normal file
@@ -0,0 +1,83 @@
|
||||
#
|
||||
# spec file for package python-SoundCard
|
||||
#
|
||||
# Copyright (c) 2018 SUSE LINUX GmbH, Nuernberg, Germany.
|
||||
#
|
||||
# All modifications and additions to the file contributed by third parties
|
||||
# remain the property of their copyright owners, unless otherwise agreed
|
||||
# upon. The license for this file, and modifications and additions to the
|
||||
# file, is the same license as for the pristine package itself (unless the
|
||||
# license for the pristine package is not an Open Source License, in which
|
||||
# case the license is the MIT License). An "Open Source License" is a
|
||||
# license that conforms to the Open Source Definition (Version 1.9)
|
||||
# published by the Open Source Initiative.
|
||||
|
||||
# Please submit bugfixes or comments via https://bugs.opensuse.org/
|
||||
#
|
||||
|
||||
|
||||
%{?!python_module:%define python_module() python-%{**} python3-%{**}}
|
||||
%define skip_python2 1
|
||||
Name: python-SoundCard
|
||||
Version: 0.2.0
|
||||
Release: 0
|
||||
Summary: Python package to play and record audio
|
||||
License: BSD-3-Clause
|
||||
Group: Development/Languages/Python
|
||||
Url: https://github.com/bastibe/SoundCard
|
||||
Source0: https://files.pythonhosted.org/packages/py3/S/SoundCard/SoundCard-%{version}-py3-none-any.whl
|
||||
Source10: https://raw.githubusercontent.com/bastibe/SoundCard/%{version}/README.md
|
||||
Source100: python-SoundCard-rpmlintrc
|
||||
BuildRequires: %{python_module cffi}
|
||||
BuildRequires: %{python_module numpy}
|
||||
BuildRequires: %{python_module pip}
|
||||
BuildRequires: %{python_module pip}
|
||||
BuildRequires: fdupes
|
||||
BuildRequires: python-rpm-macros
|
||||
Requires: pulseaudio
|
||||
Requires: python-cffi
|
||||
Requires: python-numpy
|
||||
BuildArch: noarch
|
||||
|
||||
%python_subpackages
|
||||
|
||||
%description
|
||||
SoundCard is a library for playing and recording audio without
|
||||
resorting to a CPython extension. Instead, it is implemented using
|
||||
the wonderful CFFI and the native audio libraries of Linux,
|
||||
Windows and macOS.
|
||||
|
||||
SoundCard is cross-platform, and supports Linux/pulseaudio,
|
||||
Mac/coreaudio, and Windows/WASAPI. While the interface is identical
|
||||
across platforms, naming schemes and block sizes can vary between
|
||||
devices and platforms.
|
||||
|
||||
SoundCard is still very early in its development. All major building
|
||||
blocks are in place, but I fully expect there to be bugs and possibly
|
||||
crashes. If you find a bug, please open an Issue, and I will try to
|
||||
fix it. Or open a Pull Request, and I will try to include your fix
|
||||
into SoundCard.
|
||||
|
||||
However, please be aware that this is a hobby project of mine that
|
||||
I am developing for free, and in my spare time. While I try to be as
|
||||
accomodating as possible, I can not guarantee a timely response to
|
||||
issues. Publishing Open Source Software on Github does not imply an
|
||||
obligation to fix your problem right now. Please be civil.
|
||||
|
||||
%prep
|
||||
%setup -T -c -n %{name}-%{version}
|
||||
cp %{SOURCE10} .
|
||||
|
||||
%build
|
||||
# Not Needed
|
||||
|
||||
%install
|
||||
%python_expand pip%{$python_bin_suffix} install --root=%{buildroot} %{SOURCE0}
|
||||
%python_expand %fdupes %{buildroot}%{$python_sitelib}
|
||||
|
||||
%files %{python_files}
|
||||
%license README.md
|
||||
%{python_sitelib}/SoundCard-%{version}.dist-info
|
||||
%{python_sitelib}/soundcard/
|
||||
|
||||
%changelog
|
||||
Reference in New Issue
Block a user