ISPOG — Is it Playable On Guitar?
ISPOG is a Python tool for automatically analyzing the playability of MusicXML scores on the classical guitar. It analyzes fretboard positions, concurrent note detection, fingerings, and barré chords, returning a colored score (green = playable, orange = difficult, red = unplayable).
- Current version: 0.9.1-alpha
- Author: Stefano Mancuso
- Supported input formats:
.musicxml,.mxl(compressed) - Output: MusicXML with note coloring based on playability
Download
| Platform | File | Notes |
|---|---|---|
| Windows | ISPOG-windows-v0.9.1.zip |
Extract and run ISPOG.exe |
| macOS | ISPOG-macos-v0.9.1.zip |
Extract and run ISPOG.app (complete .app bundle) |
Note: alpha build, not digitally signed. On macOS you may need to authorize the app via System Preferences → Security & Privacy on first launch (Gatekeeper blocks unsigned/non-notarized apps).
Quick usage
- Launch the application.
- Load a MusicXML file via "Load MusicXML File".
- Select the tuning (standard, Drop D, Open G, or custom) and number of frets.
- Click "Analyze Playability".
- Save the resulting colored file when prompted by the save dialog.
Online version
An interactive Gradio-based version is available as a Hugging Face Space: https://ispog.onrender.com/
License
Use is permitted exclusively for research and educational purposes. Commercial redistribution and reverse engineering for the purpose of redistributing the source code are not permitted. For specific usage requests, please contact the author.
Citation
If you use ISPOG in a research context, please cite the associated academic paper:
Crecchi, Niccolò, and Stefano Mancuso. “Dealing with a Guitar's Historical Limit through Computer-Assisted Composition.” In Sounding the Posthuman: Proceedings of the 25th Colloquium on Music Informatics. L’Aquila, Italy, 13–16 October 2026. Forthcoming.
The ISPOG software can be cited as:
Mancuso, Stefano. ISPOG — Is it Playable On Guitar? Version 0.9.1-alpha, 2026. StefanoMancuso88/ISPOG_0.9.1(.).