{"id":18847861,"url":"https://github.com/zmoon/melplot","last_synced_at":"2025-04-14T08:10:23.700Z","repository":{"id":59537032,"uuid":"480075262","full_name":"zmoon/melplot","owner":"zmoon","description":"Plot melodeon layout diagrams","archived":false,"fork":false,"pushed_at":"2025-03-03T20:51:42.000Z","size":56,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T23:17:24.885Z","etag":null,"topics":["melodeon","music"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zmoon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-10T16:30:44.000Z","updated_at":"2025-03-03T20:51:43.000Z","dependencies_parsed_at":"2023-10-04T23:16:26.444Z","dependency_job_id":"98ef9380-6e5d-4f3a-bf30-d731ca561d9a","html_url":"https://github.com/zmoon/melplot","commit_stats":{"total_commits":56,"total_committers":2,"mean_commits":28.0,"dds":0.1785714285714286,"last_synced_commit":"4be164c3b49280e6e156bee92aae995705efbd8d"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmoon%2Fmelplot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmoon%2Fmelplot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmoon%2Fmelplot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmoon%2Fmelplot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zmoon","download_url":"https://codeload.github.com/zmoon/melplot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248843867,"owners_count":21170492,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["melodeon","music"],"created_at":"2024-11-08T03:09:53.218Z","updated_at":"2025-04-14T08:10:23.659Z","avatar_url":"https://github.com/zmoon.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# melplot\n\n_Plot melodeon[^dba] layout diagrams_\n\n[![Version on PyPI](https://img.shields.io/pypi/v/melplot.svg)](https://pypi.org/project/melplot/)\n[![Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip)\n\n\u003cimg src=\"https://user-images.githubusercontent.com/15079414/170375705-f7c56244-2f58-4237-8f70-1562df22206e.png\"\n     alt=\"Standard 2-row, 21-key D/G layout\"\n     width=\"667\"\n     \u003e\n\n## Notes\n\n### Inspiration\n\n- standard 21-key D/G with acc. notes highlighted and piano-key octave numbers marked:\n  \u003chttp://forum.melodeon.net/files/site/keyboards/2%20Row%20-%20D_G%20-%20with%20accidentals.jpg\u003e\n- standard 21-key D/G with notes on stave, from [Mel Forum](http://forum.melodeon.net):\n  \u003chttp://forum.melodeon.net/files/site/DGwithStave.pdf\u003e\n- as above, with ABC notation labels added, from [Daddy Long Les](https://www.daddylongles.com/dg-melodeon-resources):\n  \u003chttps://www.daddylongles.com/_files/ugd/2a4ead_6501161c36fa470fbb1f64d24261ad9d.pdf\u003e\n- Dipper blank 30-key Anglo concertina scheme, with push/pull \"pills\" and piano keyboard with octaves highlighted:\n  \u003chttp://www.johndipper.co.uk/downloads/blank-scheme.pdf\u003e\n- 20-key Anglo concertina with fancy buttons and octaves notated, [from concertina.com](http://www.concertina.com/fingering/index.htm):\n  \u003chttp://www.concertina.com/fingering/images/anglo20-W1000H300.gif\u003e\n- Rick Mohr's layout, described [here](http://rickmohr.net/music/melodeon.asp), simple and clean, effective use of colors:\n  \u003chttp://rickmohr.net/music/3row.pdf\u003e\n- standard 12-key G/C with notes on stave, fixed solfège, and octave numbers, from Mel Forum:\n  \u003chttp://forum.melodeon.net/files/site/keyboards/GC_with_accidentals_showing_notes_on_stave.pdf\u003e\n- 3-row D/G/acc with fixed solfège coloring treble buttons by octave, by Bob Ellis:\n  \u003chttp://forum.melodeon.net/files/site/Ellis3row.pdf\u003e\n\n### TODO\n\n_and ideas_\n\n- [x] basic diagram using mpl\n- [ ] different ways to indicate octaves (e.g. color; piano key notation or wrt. root)\n- [ ] different options for pitch labels (ABC, piano key notation, scale degrees)\n- [ ] plotting notes on stave\n- [x] CLI\n- [x] first PyPI release\n- [ ] HTML/CSS output option\n- [ ] fancier button style option (some 3-D-ness)\n- [ ] draw connections in bellows direction for consecutive notes or chord\n- [ ] docs build with layout library\n\n### Input format\n\nASCII representation of the layout.\n\nIdeas:\n\n- notes in ABC notation, push/pull separated by `/` or `|`, push/pull pairs separated by whitespace\n- for each row, specify horizontal offset in the layout (zero implicit; e.g. 0.5 for the second row in a typical 11/10 layout)\n  - maybe like `x0.5` instead of just `0.5`, to emphasize just space\n- bass chords also in ABC notation, but maybe also support the common `+`/`-`?\n\n### Layout sources\n\n- [Mel Forum 2-row](http://forum.melodeon.net/index.php/page,keyboard_2_row.html)\n- [Mel Forum 2.5-row](http://forum.melodeon.net/index.php/page,keyboard_25_row.html)\n- [Mel Forum 3-row](http://forum.melodeon.net/index.php/page,keyboard_3_row.html)\n- [bass layouts from Squeezehead](http://squeezehead.com/keyboard-layouts/basses/LAYOUTS.html)\n- [various layouts and notes from Orest](http://www.geocities.ws/kozulich/layouts.html) [^pop]\n\n[^dba]: [Diatonic button accordion](https://en.wikipedia.org/wiki/Diatonic_button_accordion) (DBA) / melodeon / \"box\" / accordéon diatonique / diato / etc. Also may later extend to plotting the layouts of other button accordion family instruments like concertinas.\n\n[^pop]: Be careful opening this link on mobile browsers, I've gotten annoying / potentially dangerous pop-ups.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzmoon%2Fmelplot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzmoon%2Fmelplot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzmoon%2Fmelplot/lists"}