Skip to main content

A small package designed to create simple melodies

Project description


PyLody is a small package designed to create simple melodies.


To create a melody you can use two methods: you can use notescript notation or add melody elements manually.

The notescript notation

The notescript notation is a little-function programming language that allows you to write a melody using the melody elements: the letter notation of notes, pauses and repeating blocks.

The letter notation of notes and pauses must contains the duration at end of the declaration: [Note or pause] [Duration (in milliseconds)] The letter notation of notes must match this regex: \w\d#? [duration] (the duration regex is \d+). The pause declaration is - [duration].

The repeating block is a part of melody that can repeat any number of times. This is the structure of this block:

[Number of times to repeat] {
	...elements to repeat...

To create an infinite repeating loop just write an asterisk (*) as the number of times to repeat.

The notescript notation supports commentaries: /The text in the slashes will be ignored/.

Creating a melody

First of all, create a MelodyBuilder object. The constructor of this class takes one optional argument —— a notescript. To play the melody call the play method.

from pylody import MelodyBuilder

mb = MelodyBuilder(notescript)

You can create a melody without the notescript. Just add elements manually:

from pylody.elements import Pause, Note, Block

# The note declaration
			duration=250)) # A4 250

# The pause declaration
mb.add(Pause(duration=250)) # - 250

# The block declaration
block = Block(repeattimes=1)

Or you can play elements separately:


from pylody import MelodyBuilder

mb = MelodyBuilder(r"""
	\ Example \
	* {
		2 {
			A4 250
			B4 250
		3 {
			A4# 250
		- 500

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PyLody-1.0.0.tar.gz (4.4 kB view hashes)

Uploaded source

Built Distribution

PyLody-1.0.0-py3-none-any.whl (4.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page