Skip to main content

MusicFlower

logo

tests codecov

build PyPI version

doc License: GPL v3

MusicFlower provides a web app and python framework for interactive music visualisation. See below for a quick start and have a look at the documentation for more information and examples.

Quickstart

Starting from a clean Python environment, install MusicFlower

$ pip install musicflower

You can now start the web app by running

$ python -m musicflower

and open it in your web browser (typically) at http://127.0.0.1:8050/ (the URL is also printed in the terminal). If you would like to customise the app, you can modify the default startup scrip (e.g. to exclude visualisers you do not need to make the app more reactive, have a look at this example for more details)

from musicflower.webapp import WebApp
import musicflower.features as f
import musicflower.visualisers as v

app = WebApp(verbose=True)                      # print additional info about registered features, callbacks etc.
f.use_chroma_features(app, n=200)               # max temporal resolution of 200
v.use_fourier_visualiser(app)                   # register visualiser and required features
v.use_keyscape_visualiser(app)                  # ...
v.use_tonnetz_visualiser(app)                   # ...
v.use_spectral_dome_visualiser(app)             # ...
app.init(figure_width=1500, figure_height=800)  # larger figures
app.run()

Problems with MP3 Files

If you experience problems with loading mp3 files, you may need to install additional codecs on your system, which are required by librosa for reading the audio files (see here).

Release files for musicflower 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for musicflower 0.1.0
File Size Uploaded
musicflower-0.1.0.tar.gz 1.3 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for musicflower 0.1.0
File Interpreter ABI Platform
musicflower-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 2.7 MB

Release files / musicflower-0.1.0.tar.gz

Download URL musicflower-0.1.0.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
0dd18765704452be135ca075f865557ce05c9d11a36215a86018bd1acbe16831
BLAKE2b-256 checksum
How to use checksums
960cf0c810782926984cb264135f3e0f8ddbd30d61ea11d8f94038b7b8d70923
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release files / musicflower-0.1.0-py3-none-any.whl

Download URL musicflower-0.1.0-py3-none-any.whl
Size 1.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
31425a2838f84199033d5e357edcdb205571a033155b79c52dbbb7484fdb3cf1
BLAKE2b-256 checksum
How to use checksums
67c48973aeb6779bc135c26a2b54360c951faaece2270f741204ff03b12a6fb1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page