Skip to content
Back to search

melrose

interactive programming of melodies, producing MIDI

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/emicklei--melrose/badge.svg)](/listings/emicklei--melrose)

HTML

<a href="/listings/emicklei--melrose"><img src="/api/listings/emicklei--melrose/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 58 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Melrōse - programming of music melodies
  2. [![Build](https://github.com/emicklei/melrose/actions/workflows/go.yml/badge.svg)](https://github.com/emicklei/melrose/actions)
  3. [![GoDoc](https://godoc.org/github.com/emicklei/melrose?status.svg)](https://pkg.go.dev/github.com/emicklei/melrose?tab=doc)
  4. ## Introduction
  5. `melrōse` is a tool to create and play music by programming melodies.
  6. It uses a custom language to compose notes and create loops and tracks to play.
  7. Write note patterns as short text expressions, then play them through a MIDI device or music app.
  8. MIDI (Musical Instrument Digital Interface) is a digital communication language that sends musical instructions—like which note to play, how long to hold it, and how hard it is struck—between electronic instruments and computers.
  9. This is an example of a simple major scale C.
  10. ```javascript
  11. sequence('c d e f g a b c5') // or use the alias "seq"
  12. ```
  13. Note sequences in your program can be changed while playing giving you direct audible feedback.
  14. See also [Blog post](http://ernestmicklei.com/melrose/introduction_melrose/)
  15. ## Choose your setup
  16. - **Try it in your browser:** Open the [Melrōse Playground](https://play.melrōse.org), enter the scale example above, connect a MIDI receiver such as GarageBand, and use the play control.
  17. - **Work locally with music files and MIDI devices:** [Install Melrōse](docs/install.md) to use its terminal REPL and connect to MIDI devices. A local installation can connect to multiple devices, with up to 16 MIDI channels available per device.
  18. - **Compose in Visual Studio Code:** Install the [Melrōse VS Code extension](https://marketplace.visualstudio.com/items?itemName=EMicklei.melrose-for-vscode) to manage music files and play music from the editor.
  19. Read the [Documentation](https://melrōse.org/) on how to use `melrōse`.
  20. ### Showcase
  21. <img src="docs/images/riboluta-melrose.png" alt="riboluta-melrose" width="80%">
  22. ### MIDI setup
  23. <img src="docs/images/melrose-port-daw.png" alt="melrose-port-daw" width="80%">
  24. ### Contributions
  25. Fixes, suggestions, documentation improvements are all welcome.
  26. Fork this project and submit small Pull requests.
  27. Discuss larger ones in the Issues list.
  28. You can also sponsor Melrōse via [Github Sponsors](https://github.com/sponsors/emicklei).
  29. ### Related tools
  30. - `melrose-mcp` <br>is a (server) tool that uses the [MCP](https://modelcontextprotocol.io/) protocol to receive expressions to play.
  31. See [melrose-mcp](https://github.com/emicklei/melrose-mcp) for details how to install and use it.
  32. - `midicyles` <br>is a tool that visualizes MIDI events using polar coordinates (notes move around in circles).See [midicyles](https://codeberg.org/emicklei/midicycles) for details how to install and use it.
  33. - `keymidi` <br>is a tool that provides an interactive OS Keyboard to send MIDI events. This can be used to control the playing of music in `melrōse`.See [keymidi](https://codeberg.org/emicklei/keymidi) for details how to install and use it.
  34. - `slidermidi` <br>is a tool that provides an interactive UI Sliders to send MIDI change event. This can be used to control the playing of music in `melrōse`.See [slidermidi](https://codeberg.org/emicklei/slidermidi) for details how to install and use it.
  35. Software is licensed under [MIT](LICENSE).
  36. &copy; 2026 [ernestmicklei.com](http://ernestmicklei.com)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.