https://github.com/pygame/parrotjoy
🦜🎮 parrotjoy is a musical machine that talks back. An audio looper, and an audio reactive video synth controllable with joy pads and dance mats. No parrots were harmed in the making of this software.
https://github.com/pygame/parrotjoy
audio looper video-synth
Last synced: 11 months ago
JSON representation
🦜🎮 parrotjoy is a musical machine that talks back. An audio looper, and an audio reactive video synth controllable with joy pads and dance mats. No parrots were harmed in the making of this software.
- Host: GitHub
- URL: https://github.com/pygame/parrotjoy
- Owner: pygame
- License: lgpl-2.1
- Created: 2019-05-16T21:31:51.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2022-12-17T14:05:22.000Z (over 3 years ago)
- Last Synced: 2025-03-28T22:09:18.631Z (about 1 year ago)
- Topics: audio, looper, video-synth
- Language: Python
- Homepage:
- Size: 1.87 MB
- Stars: 12
- Watchers: 3
- Forks: 2
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# parrotjoy - a pygame 2 project.
For making music, and visuals. [https://github.com/pygame/parrotjoy](https://github.com/pygame/parrotjoy)
## Get started.
### Installation
```
python3 -m venv venv
. ./venv/bin/activate
pip install -r requirements.dev.txt
parrotjoy
```
### Joypad controller instructions
There are 4 audio tracks.
The first two tracks
Pressing the numbered buttons (1,2,3,4) in combination with `modifier` ones.
- R1 ) track.start_new_next
- R2 ) track.add_to_next
- L1 ) track.erase
If recording, track.finish()
else: track.play()
#### Trimming with analog joy sticks.
The analog controllers can be used to trim a track.
This is useful if you record too much sound, or you want to line it up with other parts.
- Left stick trims the start of the track. Tap the left stick to the right to have less of the sound from the beginning.
- Right stick is for trimming the end of the track.
### Keyboard control.
- `s`, start recording a new track
- `S`, record over the top of an existing track
- `f`, finish recording track.
- `p`, play
- `w`, trim the START of the sound. Get MORE sound on LEFT of sound.
- `e`, trim the START of the sound. Get LESS sound on LEFT of sound.
- `r`, trim the END of the sound. Get LESS sound on RIGHT of sound.
- `t`, trim the END of the sound. Get MORE sound on RIGHT of sound.
- `space`, adjust the BPM timer. Tap it in time until the BPM is as you like.
- '0', use Looper scene.
- '9', use VideySynth scene.
- '8', strawberries.
### Running tests.
Tests can be found in the tests/ folder.
Type `pytest`.
Or run `python -m tox`
Tests are run on mac, linux, windows when there is a pull request made.
### releasing
Releasing is tested with python3.7(not python2 or any other version).
To the python package index (pypi).
```
rm -rf dist/*
python setup.py sdist bdist_wheel
twine upload dist/*
```
On windows:
```
python setup.py bdist_msi
dir build/*.msi
```
On mac:
```
python setup.py bdist_dmg
ls build/*.dmg
```
## Licenses
#### Code license
License for code will be the same as the pygame license (LGPL).
Check the licenses for the dependencies.
## parrotjoy uses
many parts made by others...
- [pygame](https://pygame.org/)
- [python](https://python.org/)
- [aubio](https://aubio.org/)
- [libsdl](https://libsdl.org/)
- ... numpy, opencv-python, pytest, cxfreeze