Skip to content

🎶 A remaster of MIDIJam, the 3D MIDI file visualizer.

License

Notifications You must be signed in to change notification settings

s11141827/midis2jam2

 
 

Repository files navigation

midis2jam2

midis2jam2 midis2jam2 midis2jam2 midis2jam2 midis2jam2

midis2jam2 is a remaster of MIDIJam, a MIDI file visualizer made by Scott Haag, last updated in 2007.

About

midis2jam2 provides a faithful recreation, staying true to the original look and feel as closely as possible. The models and textures used in midis2jam2 are the original assets from MIDIJam, designed by MIDIJam’s creator Scott Haag. midis2jam2 will complete the GM-1 implementation, allowing every MIDI instrument to be visualized.

Future versions may add extended features, such as custom graphics, real time MIDI visualization, and others.

Running

Easy mode

Simply download the latest version and run the file for your system. Follow the on-screen instructions for installing midis2jam2.

Hard mode

If you want to experience the latest midis2jam2 updates in between releases, you can download a CI build. Note: these builds are unstable, so I won’t provide any support for them (although, you should submit issues for pertinent bugs).

Getting the binary

You can either use a prebuilt binary or build from source.

Using a prebuilt binary

To begin, download a build from the builds page. Move midis2jam2-xxxxxxxx.jar to a new folder (the Xs are a placeholder here; when you download the jar, this is the beginning of the commit hash).

Building from source

To build midis2jam2, run

$ git clone https://github.com/wyskoj/midis2jam2
$ cd midis2jam2
$ ./gradlew shadowjar

The jar file appears in build/libs. Copy it to a new folder.

You will need at least Java 15 in order for a successful build.

Running

To run midis2jam2, simply execute the jar file:

$ java -jar midis2jam2.jar

You can optionally specify the relative or absolute path to a MIDI file. midis2jam2 will load and play the file using the default synthesizer Gervill:

$ java -jar midis2jam2.jar path/to/midifile.mid

FAQ & Troubleshooting

The program closed, but all the notes are sustaining.

Press the MIDI panic button on your synthesizer to stop the sound.

I think something is broken.

Check the issues page and make sure there isn’t already a relevant issue open. If there isn’t, create an issue and use the bug report template.

Why doesn’t instrument X appear?

It’s likely I haven’t implemented it yet. Check this page for more information.

MidiUnavailableException: There is not enough memory available for this task…​

This can happen if you attempt to use ghost/phantom MIDI ports that appear visible on your machine. Try restarting your computer or reconnecting your MIDI devices.

Contributing

Fork and make a pull request to directly make changes. Open an issue to request features and report bugs. Please ensure you use a template, and ensure you write good issues.

License

midis2jam2 is released under the GNU General Public License 3. The software comes with no warranty. Assets Copyright © 2007 Scott Haag (used with permission).

About

🎶 A remaster of MIDIJam, the 3D MIDI file visualizer.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 100.0%