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!

• Host: GitHub
• URL: https://github.com/UnsignedArduino/Musical-Images-Generator
• Owner: UnsignedArduino
• Created: 2022-01-03T21:54:20.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-04-05T22:50:15.000Z (about 2 years ago)
• Last Synced: 2024-01-20T20:14:30.034Z (5 months ago)
• Topics: arcade, extension, extension-helper, helper, makecode, makecode-arcade, makecode-arcade-extensions, makecode-extension, midi
• Language: Python
• Homepage:
• Size: 5.86 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Lists

• Awesome-Arcade-Extensions - script

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.