Skip to main content

Simple and fast library to convert midi files to video

Project description

Midi2Vid - Simple and Fast Midi to Video Converter

Midi to video converter. This program renders the notes of a midi file to a video. The renderer is built on top of the pygame library and uses multiple processes to generate the frames of the video. It then uses ffmpeg to convert the frames to a video. It also uses the fluidsynth library to render the midi file to a wav file.

Example

Installation

Install from github using pip:

pip install git+https://github.com/pianoviz/midi2vid.git

Build with docker:

docker build -t midi2vid-base .
docker run --rm -v $(pwd):/app midi2vid-base -i data/example.mid -o your_output.mp4

Build from source:

git clone https://github.com/pianoviz/midi2vid.git
cd midi2vid
pip install -e .

Usage

midi2vid -i <input_midi_file> -o <output_video_file>

Options

-i, --input: Input midi file
-o, --output: Output video file
--config: Path to the configuration file (default: config/default.json)

Configuration

The configuration file is a JSON file that specifies various parameters for the video generation. Here is an example configuration file:

{
  "soundfont_path": "data/soundfont.sf2",
  "max_note_length": 50,
  "n_processors": 4,
  "screen_width": 1920,
  "screen_height": 1080,
  "bpm": 120,
  "fps": 30,
  "speed": 200,
  "white_note_color": [255, 255, 255],
  "black_note_color": [49, 49, 49],
  "background_color": [43, 43, 43],
  "octave_lines_color": [92, 92, 92],
  "note_color": [179, 44, 49],
  "dark_note_color": [113, 34, 36],
  "right_note_color": [168, 255, 145],
  "left_note_color": [176, 202, 229],
  "dark_right_note_color": [118, 208, 68],
  "dark_left_note_color": [124, 142, 151],
  "estimate_hands": false
}

The estimate_hands parameter is experimental and is used to estimate the hand positions based on the notes played. It is currently under development and may not work as expected.

Example

There is an example midi file in the data directory. You can run the following command to generate a video from the example midi file:

midi2vid -i data/example.mid -o example.mp4

Dependencies

  • pygame
  • ffmpeg
  • fluidsynth

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

License

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

midi2vid-0.0.3.tar.gz (89.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

midi2vid-0.0.3-py3-none-any.whl (12.3 kB view details)

Uploaded Python 3

File details

Details for the file midi2vid-0.0.3.tar.gz.

File metadata

  • Download URL: midi2vid-0.0.3.tar.gz
  • Upload date:
  • Size: 89.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.15

File hashes

Hashes for midi2vid-0.0.3.tar.gz
Algorithm Hash digest
SHA256 fd02f7150a40287dfce6808dabf36548b1c9c4bf4ce3ef07f924067ab3d8a0d4
MD5 fbdaa5053d5857dd52a0e8739e457cd0
BLAKE2b-256 4049bd7ffee6cbe4cda0540d8b4d2a0157709408eb109fa1cd48457f130c18a7

See more details on using hashes here.

File details

Details for the file midi2vid-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: midi2vid-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 12.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.15

File hashes

Hashes for midi2vid-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7b1fb8f73b40ac89313fd806ef5b251fddcb2ba135324f9723b99a8314441beb
MD5 ea1e16c99009838067399b86131556a7
BLAKE2b-256 3353817163aa5f6d75a34728bd48d5c453216ad2d9d8949e0ab5f2feef322a77

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page