Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/UnsignedArduino/Musical-Images-Generator

A Python program to generate images compatible with the Musical-Images extension in MakeCode Arcade!
https://github.com/UnsignedArduino/Musical-Images-Generator

arcade extension extension-helper helper makecode makecode-arcade makecode-arcade-extensions makecode-extension midi

Last synced: 3 months ago
JSON representation

A Python program to generate images compatible with the Musical-Images extension in MakeCode Arcade!

Awesome Lists containing this project

README

        

# Musical-Images-generator

A Python script that generates images compatible with the
[Musical-Images](https://github.com/UnsignedArduino/Musical-Images) extension
for MakeCode Arcade!

## Installation

### Install via binary

1. Download an executable (only have binaries for 64-bit Windows currently)
for your platform from the
[releases page](https://github.com/UnsignedArduino/Musical-Images-Generator/releases).
3. Open a terminal at where you downloaded the binary.
4. Instead of running `python main.py ` run the binary instead.
(If the binary is named `musical-images-generator.exe` then you can just run
`musical-images-generator `)

### Install via source

1. Install Python 3.9 or newer.
2. Download the code, either via `git clone` (You'll need `git` for that
obviously) or download via ZIP and extract to somewhere.
3. Install the dependencies needed in
[`requirements.txt`](https://github.com/UnsignedArduino/Musical-Images-Generator/blob/main/requirements.txt).

## Usage

Run `python main.py` or the binary in the terminal and pass in a path to a
MIDI file. A text file with MakeCode Arcade images should be in the same
directory as the MIDI file. Open it using your favorite text editor and copy
all the images into image blocks or an animation block in the MakeCode Arcade
editor. The images will be limited to 512x88 (88 keys on piano) so you should
make your animation/images that big. The last image will usually be smaller,
which you can trim down to save space when compiling.