https://github.com/fjebaker/butterflies-py
Python module for interfacing the with Butterflies-MC sketches.
https://github.com/fjebaker/butterflies-py
Last synced: about 1 year ago
JSON representation
Python module for interfacing the with Butterflies-MC sketches.
- Host: GitHub
- URL: https://github.com/fjebaker/butterflies-py
- Owner: fjebaker
- License: gpl-3.0
- Created: 2020-04-10T10:46:31.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-06T21:57:13.000Z (almost 3 years ago)
- Last Synced: 2025-04-05T01:06:58.425Z (about 1 year ago)
- Language: Python
- Size: 21.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Butterflies-Py
Python module for interfacing the with Butterflies-MC sketches.
## Installation
This script requires the `PyAudio` package. On different operating systems, the necessary prerequisites are
- **OSX**: requires `portaudio` aswell
```bash
brew update
brew install portaudio
brew link --overwrite portaudio
```
(*todo: others*)
### Install from git
To setup, use
```bash
git clone https://github.com/Dustpancake/Butterflies-Py
cd Butterflies-Py
pip install .
```
## Running
In the current version (alpha 1.0) you'll need to have a `test.wav` in the root of the project directory, i.e. `Butterflies-Py/`. An arduino uno device running the [Butterflies-MC script](https://github.com/Dustpancake/Butterflies-MC) must be connected to the machine, and the appropriate `/dev/` used in `__main__.py`:
```python
with AudioHandler() as ah, SerialCallback('/dev/USB-DEVICE') as sc:
ah.load_song('test.wav')
ah.start(sc)
```
Then, starting the script is simply
```bash
python .
```