CreativePython 0.1.3

A Python-based software environment for developing algorithmic art projects.

CreativePython

CreativePython is a Python-based software environment for learning and developing algorithmic art projects. It mirrors the JythonMusic API, and is powered by PySide6 and portaudio.

CreativePython is distributed under the MIT License.

• Homepage
• Download All Examples [ZIP]

This package is still under development.

Beginner Installation (IDLE)

1. Download and install the latest version of Python.

2. Download the CreativePython Setup Script.

3. Open creativePythonSetup.py with IDLE, Python's Integrated Development Learning Environment.

4. From the IDLE toolbar, select Run, then Run Module.

5. CreativePython will check for its requirements on your system, download any missing requirements, and install its libraries.

6. When you see [CreativePython Setup]: CreativePython installed successfully., you're all done! You're ready to start using CreativePython.

NOTE: You can use the setup script in any Python3 environment - not just IDLE!

Custom Installation

Windows

Install CreativePython using pip:

python -m pip install CreativePython

MacOS

Use Homebrew to install the prerequisite portaudio library, then install CreativePython using pip:

brew install portaudio
pip install CreativePython

Linux

Use apt, or your preferred package manager, to install the prerequisite portaudio library, then install CreativePython using pip:

sudo apt-get portaudio
pip install CreativePython

Using CreativePython

Importing Libraries

CreativePython's core modules are the music, gui, image, timer, osc, and midi libraries. You can import these libraries into your python code using:

import music
from music import *
from music import Note, Play, C4, HN

Or a similar statement. CreativePython includes a number of useful constants, so we recommend using wildcard imports like from music import *.

NOTE: The first time you import music, CreativePython will ask permission to download a high-quality soundfont (FluidR3 G2-2.sf2) for you. You should only have to do this once.

Running CreativePython programs

CreativePython is designed for use in Python's Interactive Mode. To use Interactive Mode, enter a command like:

python -i <filename>.py

Example

Download playNote.py:

# playNote.py
# Demonstrates how to play a single note.
 
from music import *        # import music library
 
note = Note(C4, HN)        # create a middle C half note
Play.midi(note)            # and play it!

In a terminal, run the code in interactive mode:

python -i playNote.py

If this is the first time you've used CreativePython, it will ask to download a soundfont.

After you do, you should hear a single C4 half-note.