arranging_guide
ChatGPTHow to do a teaching task well in PlayableNotes: "arrange-for-student" (simplify for a level), "change-key", "compose" (write a new piece from a description), "check-score" (review things to check after reading), or "playablenotes" (tools and KM in depth). Read before such changes.
card_engrave_measure
ChatGPTCard: engrave one measure (MEI) for the measure editor.
card_engrave_pages
ChatGPTCard: engrave MEI as pages (SVG), for the screen or for a PDF.
card_open_library
ChatGPTCard: copy a library piece into the account.
card_openings
ChatGPTCard: pictures of the opening bars (SVG) of the user's scores and of library pieces, for the score list.
card_save
ChatGPTCard: save the user's own edit as a new version.
card_scores
ChatGPTCard: the user's scores and library matches for the home view.
card_shares
ChatGPTCard: the practice links of a score, and making a new one.
card_state
ChatGPTCard: status, version (the current one, or the one asked for), KM, settings and links of a score.
copy_score
ChatGPTUse this when the user wants a second arrangement of one of their scores while keeping the original, e.g. one version per student or an easier and a harder one: copies its current version into a new score. Nothing is read again.
create_score
ChatGPTUse this when the user asks you to compose, write or create an original piano piece, exercise or study from a description, with no sheet music attached: "a short waltz in F for a beginner", "a C major warm-up in thirds", "a lullaby for my student who just learned eighth notes". Call arranging_guide compose first, write the whole piece as KM yourself, and save it here. KM with any problem (a measure with the wrong number of beats, an unknown symbol) is not saved: the reply lists each problem by line, so fix them and call again. Saved, it becomes a new score in their PlayableNotes account, engraved and playable, which they can then change like any other. Do not use to write out copyrighted songs from memory (offer an original piece in that style instead), for music the user attached (read_sheet_music), or to change an existing score (edit_score).
edit_score
ChatGPTUse this to change the notes of a score: simplify it for a student's level, transpose it to another key, make the left hand easier, fix wrong notes, change the rhythm or style, and so on. Saves the change as a new version (earlier versions are kept). Read the score with get_score first. Give the version you read, a one-sentence summary, and either the measures you changed (all lines of each, including any KEY/TIME line for it) or the whole new KM. Changes that add KM errors are refused with the problems to fix.
find_library_piece
ChatGPTUse this when the user names a well-known piano piece (classical, public domain: Bach, Mozart, Beethoven, Chopin, Satie, hymns and the like) that they want to play, simplify, transpose or arrange and have not attached: searches the PlayableNotes library by title or composer. Do not use for songs under copyright or for music the user attached (use read_sheet_music).
get_score
ChatGPTUse this before any change to a score (edit_score), to answer questions about its notes (key, time signature, what is in measure 5), or to check whether a reading has finished: returns the score as KM text with its version number and things to check.
my_scores
ChatGPTUse this when the user wants to see, find or pick one of their own PlayableNotes scores (sheet music they uploaded, opened from the library or arranged before), or asks how many credits they have. Lists them newest first in the PlayableNotes card, optionally filtered by title or composer, and reports the credit balance.
open_library_piece
ChatGPTUse this after find_library_piece, when the user wants to play, edit or arrange that piece: copies it into their PlayableNotes account as an editable, playable score and shows it. Ready at once.
open_score
ChatGPTUse this when the user wants to see, hear, play back, print or hand-edit one of their PlayableNotes scores: shows it in the card as engraved sheet music with playback, a measure editor and downloads (PDF, MIDI, MusicXML).
read_sheet_music
ChatGPTUse this when the user attaches piano sheet music (photos or scans of the pages, screenshots, PDFs, or a MusicXML file) and wants to play it, hear it, edit it, transpose it, simplify it or arrange it: reads it with optical music recognition into an editable, playable score in their PlayableNotes account. Uses the account's credits, 1 per line of music (pages without music are skipped, a MusicXML file uses none, and none are used if reading fails). Do not use for images that are not sheet music, or for music for other instruments than piano (two staves). The user agreed, when connecting, that they own the music or may use it for teaching.
set_score_details
ChatGPTUse this when the user wants a score's printed title or composer changed, or its playback slower or faster. Not for changing notes (use edit_score).
settings.read
ChatGPTUse this to read the defaults for new scores made in ChatGPT: paper size (letter or A4), music size (percent) and playback tempo. ChatGPT's settings screen calls it; it changes nothing.
settings.update
ChatGPTUse this when the user changes the defaults for new scores made in ChatGPT (paper size, music size, playback tempo) in the settings screen or asks to. Affects only scores made afterwards; existing scores keep their own settings.
share_with_student
ChatGPTUse this when the teacher wants to send a score to a student to practise. Makes a practice link: a fixed copy of the score's current version that they can open, play (with tempo, loops and hands separately) and print, without an account. Name it after the student. Returns the link to give them. The link is public: anyone who has it can open that copy, so share it only with the student.