parrotjoy - a pygame 2 project.

For making music, and visuals. 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
• python
• aubio
• libsdl
• ... numpy, opencv-python, pytest, cxfreeze