Skip to content

Latest commit

 

History

History
122 lines (72 loc) · 2.38 KB

README.md

File metadata and controls

122 lines (72 loc) · 2.38 KB

parrotjoy - a pygame 2 project.

For making music, and visuals. https://github.com/pygame/parrotjoy

parrot joy

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...