plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "playablenotes",
  "version": "1.2.5",
  "description": "Read piano sheet music from photos, scans and PDFs, or write a new piece from a description, into scores you can play, edit, transpose, simplify and arrange for each student.",
  "author": {
    "name": "PlayableNotes",
    "email": "support@playablenotes.com",
    "url": "https://playablenotes.com"
  },
  "homepage": "https://playablenotes.com",
  "keywords": [
    "sheet music",
    "piano",
    "piano sheet music",
    "music notation",
    "score editor",
    "music editor",
    "edit sheet music",
    "read sheet music",
    "scan sheet music",
    "photo to sheet music",
    "optical music recognition",
    "OMR",
    "PDF to MusicXML",
    "MusicXML",
    "MIDI",
    "transpose",
    "change key",
    "simplify music",
    "easy piano",
    "arrange",
    "arrangement",
    "piano teacher",
    "piano lessons",
    "music teacher",
    "music education",
    "practice",
    "beginner piano",
    "classical piano",
    "hymns",
    "compose music",
    "write a piano piece",
    "music composition",
    "piano exercises"
  ],
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/onboarding/SKILL.md",
      "interface": {
        "displayName": "PlayableNotes",
        "shortDescription": "Edit & play piano sheet music",
        "longDescription": "PlayableNotes turns piano sheet music into scores you can play, edit and arrange, right in ChatGPT.\n\nSend photos, scans, screenshots or a PDF of piano music and PlayableNotes reads it, note by note, into an engraved score you can hear at any tempo, edit measure by measure, and download as PDF, MIDI or MusicXML. Or start from the library of public-domain piano pieces (Bach, Mozart, Beethoven, Chopin, Satie, hymns and more), or ask ChatGPT to write a new piece or exercise from a description, such as \"a short waltz in F for a first-year student\".\n\nThen ask ChatGPT for the version you need:\n\u2022 Simplify a piece for a beginner, or for your student's level\n\u2022 Transpose it to any key\n\u2022 Make the left hand easier, or change the rhythm or style\n\u2022 Fix a wrong note, or check the score for reading mistakes\n\u2022 Make a copy for each student, and a practice link they can open, play, loop and print without an account\n\nEvery change is saved as a new version, so nothing is lost. Your scores live in your PlayableNotes account, the same one as playablenotes.com, where you can keep editing on a bigger screen.\n\nWho it's for: piano teachers and their students, church and school musicians, and anyone who plays piano from sheet music.\n\nLimitations: PlayableNotes reads piano music (a treble and a bass staff), from music you own or may use for teaching. Blurry or dark photos read less well; any measure can be fixed by hand or by asking ChatGPT.",
        "developerName": "PlayableNotes",
        "category": "Creativity",
        "capabilities": [
          "Read piano sheet music from photos, scans, screenshots and PDFs",
          "Import MusicXML files",
          "Compose new pieces and exercises from a description",
          "Play scores back at any tempo",
          "Simplify music for a student's level",
          "Transpose to any key",
          "Make the left hand easier",
          "Edit notes measure by measure",
          "Check a score for reading mistakes",
          "Download PDF, MIDI and MusicXML",
          "Share practice links with students",
          "Copy a score for another arrangement",
          "Open public-domain piano pieces from the library",
          "Keep every version of every score"
        ],
        "websiteURL": "https://playablenotes.com",
        "supportURL": "https://playablenotes.com/support",
        "privacyPolicyURL": "https://playablenotes.com/privacy",
        "termsOfServiceURL": "https://playablenotes.com/terms",
        "defaultPrompt": [
          "Read this sheet music so I can hear it and edit it.",
          "Write a short waltz in F for a first-year piano student.",
          "Make an easier version of F\u00fcr Elise for a beginner."
        ],
        "brandColor": "#7c3aed",
        "brandColorDark": "#a78bfa",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/composer-icon.png",
        "composerIconDark": "./assets/composer-icon-dark.png",
        "screenshots": [
          "./assets/screenshot-read.png",
          "./assets/screenshot-compose.png",
          "./assets/screenshot-simplify.png"
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "A piano teacher photographed one page of a beginner minuet they teach and wants it as a playable, editable score.",
              "prompt": "Read this sheet music so I can hear it and edit it.",
              "tools_triggered": "read_sheet_music",
              "expected_behavior": "Reads the attached page (about 6 lines of music), shows the score card with reading progress, then the engraved Minuet in G with playback.",
              "file_attachment_urls": [
                "https://playablenotes.com/review/minuet-in-g-page-1.jpg"
              ]
            },
            {
              "description": "A piano teacher wants an easier version of a famous piece for a first-year student.",
              "prompt": "Find F\u00fcr Elise and make an easier version for my beginner student.",
              "tools_triggered": "find_library_piece, open_library_piece, arranging_guide, get_score, edit_score",
              "expected_behavior": "Opens F\u00fcr Elise from the PlayableNotes library as the teacher's score, then saves a simpler version 2 (melody kept, fewer notes, an easier left hand) and sums up the changes in a sentence or two."
            },
            {
              "description": "A piano teacher's beginner student struggles with the F sharp in a piece; the teacher wants it moved to C major.",
              "prompt": "Open the Minuet in G major from the PlayableNotes library and transpose it to C major for my student.",
              "tools_triggered": "find_library_piece, open_library_piece, arranging_guide, get_score, edit_score",
              "expected_behavior": "Opens the Minuet in G major, then saves version 2 in C major (no sharps in the key signature, every note a fourth lower or a fifth higher, same rhythms) and says what changed."
            },
            {
              "description": "A piano teacher wants a short new piece for a first-year student who has just learned quarter and half notes.",
              "prompt": "Write a short waltz in F major for my first-year piano student.",
              "tools_triggered": "arranging_guide, create_score",
              "expected_behavior": "Writes an original waltz in F major in 3/4 (8 to 16 measures, simple left hand), saves it as a new score labelled Composed, and shows it engraved and playable in the card."
            },
            {
              "description": "A piano teacher wants to send a piece to a student to practise at home.",
              "prompt": "Open the Minuet in G major from the PlayableNotes library and make a practice link for my student Emma.",
              "tools_triggered": "find_library_piece, open_library_piece, share_with_student",
              "expected_behavior": "Returns a playablenotes.com/p/\u2026 link named for Emma that opens the score without an account, with playback, tempo, loops and printing."
            }
          ],
          "negative": [
            {
              "description": "Lyrics: PlayableNotes reads, edits and writes piano music, not words. ChatGPT should answer in ordinary chat without calling a PlayableNotes tool or claiming to have made a score.",
              "prompt": "Write lyrics for a birthday song for my student."
            },
            {
              "description": "A copyrighted song the user has not attached: PlayableNotes must not write it out from memory. It may offer to read sheet music the user owns and attaches, or to write an original piece in that style.",
              "prompt": "Get me the piano sheet music for the latest Taylor Swift single."
            },
            {
              "description": "A general music-theory question: nothing to read, write, edit or share, so ChatGPT answers in ordinary chat without calling a PlayableNotes tool.",
              "prompt": "What's the difference between a sonata and a sonatina?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin sells nothing and shows no prices, plans, upgrade offers or links to pay. Users sign in to their existing PlayableNotes account and use what it already includes. Reading attached sheet music uses the account's credits; if the account has too few, the tool says how many are needed and how many it has, with no link.",
        "demo_recording_url": "https://www.loom.com/share/752e305bfbaa4c089b25a52e6f637024"
      },
      "publication": {
        "release_notes": "Clearer tool descriptions, shorter replies after reading sheet music, and a simpler get-started."
      },
      "apps": "./.app.json"
    }
  }
}