CLI-MIDI-Player

CLI-MIDI-Player is a command-line interface (CLI) program that allows you to play MIDI files easily from your terminal. With features to list available MIDI files, play MIDI files by index or name, specify a soundbank, and reset the playback, CLI-MIDI-Player provides a straightforward and efficient way to enjoy your MIDI music.

Features

• List available MIDI files
• Choose the playback device by name or by index
• Play a list of MIDI files
• Specify a soundbank for playback
• Reset the playback method

Usage

cli-midi-player.exe [OPTIONS] [MIDI_FILES...]

Options

• -l : List all available MIDI files.
• -p <index> : Play the MIDI file on the device with the given index.
• -P <name> : Play the MIDI file on the device with the given name.
• -s <soundbank> : Specify the soundbank to be used for playback.
• -r : Reset the playback method.

Arguments

• MIDI_FILES : List of MIDI files to play.

Examples

List all available MIDI files

cli-midi-player.exe -l

Play a MIDI file on a specific device by index

cli-midi-player.exe -p 1 example.mid

Play a MIDI file on a specific device by name

cli-midi-player.exe -P "Unknow vendor USB MIDI Interface 2.84" example.mid

Specify a soundbank for playback

cli-midi-player.exe -s soundbank.sf2

Reset the playback method

cli-midi-player.exe -r

Play a list of MIDI files

cli-midi-player.exe file1.mid file2.mid file3.mid

Installation

1. Download the latest release from the releases page.
2. Extract the downloaded archive.
3. Move the executable to a directory in your PATH.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request with your changes. For major changes, please open an issue first to discuss what you would like to change.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Thanks to tomari the original coder of the project : Old Project

Building the Project

To build the CLI-MIDI-Player project, follow these steps:

Prerequisites

• Ensure you have Maven installed on your system.
• Download and install Launch4j to create a Windows executable wrapper.

Steps to Build

1. Clone the repository:

   git clone https://github.com/yourusername/cli-midi-player.git
   cd cli-midi-player

2. Package the project using Maven:

   Run the following command to package the project into a JAR file:

   mvn package

   This will generate a target/cli-midi-player-<version>.jar file.

3. Create an executable wrapper using Launch4j:

   • Open Launch4j.
   • Load the launch4j.xml configuration file included in the repository.
   • Ensure that the JAR file path in the configuration points to the generated JAR file (target/cli-midi-player-<version>.jar).
   • Configure other settings as needed, such as the output executable name and icon.
   • Click on the Build Wrapper button to create the .exe file.

4. Run the executable:

   After creating the .exe file, you can run it directly from your terminal:

   cli-midi-player.exe [OPTIONS] [MIDI_FILES...]

Follow these steps to successfully build and package the CLI-MIDI-Player project into a Windows executable.