Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/rainbow-dreamer/sfplayer

This is an easy-to-use SoundFont player that supports playing MIDI files using SoundFont files
https://github.com/rainbow-dreamer/sfplayer

midi music musicpy python sf2 soundfont soundfonts

Last synced: 2 months ago
JSON representation

This is an easy-to-use SoundFont player that supports playing MIDI files using SoundFont files

Host: GitHub
URL: https://github.com/rainbow-dreamer/sfplayer
Owner: Rainbow-Dreamer
License: lgpl-2.1
Created: 2021-11-28T17:47:13.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2024-06-23T05:46:00.000Z (7 months ago)
Last Synced: 2024-06-23T06:58:20.588Z (7 months ago)
Topics: midi, music, musicpy, python, sf2, soundfont, soundfonts
Language: Python
Homepage:
Size: 126 MB
Stars: 16
Watchers: 1
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# SfPlayer

## Introduction

SfPlayer is a simple SoundFont player that has the following functionality:

* Loading MIDI files and SoundFont files, play MIDI files with the loaded SoundFont files
* Drag and drop support of MIDI files and SoundFont files
* Support Standard MIDI File (SMF) and RIFF MIDI file for MIDI files, sf2 / sf3 / dls for SoundFont files
* MIDI playback bar with full time control and pause / unpause / stop functionality
* Volume and BPM control widgets
* MIDI CC and pitch bend control widgets
* Tempo changes in MIDI file reflect directly on the BPM control bar
* Reverb and chorus parameters control widgets
* Change the instruments of MIDI channels to what you like when playing
* Program changes in MIDI file reflect directly on the instrument box
* Export rendered audio of MIDI file with the SoundFont file it plays with to mp3 / wav / ogg files and so on
* Detect the most possible main key of the MIDI file using music theory algorithm
* Perform an entire modulation from a mode to another mode on the MIDI file and play
* Play the MIDI file in reverse
* Play the MIDI file as if it is played on a 88-key piano but the piano keys are reversed
* Play the MIDI file in negative harmony of a given key
* More functionality is on the way!

## Usage

### Platform

SfPlayer currently only supports Windows, you can open `SfPlayer.exe` to use the software. On Linux and macOS, you can install python >= 3.7 and install the required packages (refer to building from source section) to run the program.

### Switching pages

Go to different pages by selecting on tabs at the top to use functionality related to the page's name.

### Playback

Click on `Choose MIDI File` button to select a MIDI file, click on `Choose SoundFont File` button to select a SoundFont file, and then click on `Play` button to start the playing of the MIDI file using the SoundFont file.

You can also drag and drop the MIDI file and SoundFont file to the window, it will automatically detect the file extension and load as MIDI file or SoundFont file.

Click on the `Play` button to start playing the MIDI file with the loaded SoundFont file, the other playing related button are used in the way they name.

Click on the playback bar or mouse drag to change the current playing position of the MIDI file.

### Synth Settings

This part is straightforward, for the control parameters like `MIDI CC` or `pitch bend`, when you select a new MIDI CC value or new channel number, the values will be updated as the current control value of the channel.

The `Volume` control widget is the general volume of the synth used to play the MIDI file with the loaded SoundFont file.

The `BPM` control widget will be automatically updated as the real-time BPM of the MIDI file when playing.

### Music Functions

The current instrument of each channel of the MIDI file when playing is shown in the `Instrument` box here, you can click on the `Channel` box to select a channel number, the current program and bank of the channel will be shown in the `Program` and `Bank` box.

You can change the current program and bank of the selected channel in the `Program` and `Bank` box.

In the `Instrument` box, the instrument names are the actual preset name of the corresponding program in the SoundFont file you use to play, while the instrument names in the `Instrument` box are the corresponding program names of the General MIDI standard.

For modulation of the MIDI file, you can enter modes like `C major` in the `From mode` and `to Mode` entry box, the note name supports both uppercase and lowercase, sharp and flat, but you need to make sure to have a space between the note name and the mode name. The supported modes are defined in `packages/musicpy/database.py` as the parameter `scaleTypes`, you can customize the supported modes by adding the new mode with the mode name and the intervals.

### Playlist

You can choose a directory to play a random MIDI file from the directory.

### Messages

The message at the bottom is used for showing errors when users are not doing correct.

## Download

Click [here](https://github.com/Rainbow-Dreamer/SfPlayer/archive/refs/heads/main.zip) to download the latest version of SfPlayer.

**Note: If you want to use `Export As Audio` function to export non-wav audio files (such as mp3, ogg), you need to download ffmpeg,
put the ffmpeg folder in C: on Windows, and then add `C:\\ffmpeg\\bin` to system environment variables, then restart the computer.
You can download ffmpeg from [here](https://github.com/Rainbow-Dreamer/musicpy/releases/latest)**

## TODO

* Adding more functionality related to music theory algorithm
* Make the user interface more organized and straightforward

## Previews

![image](previews/1.jpg)

![image](previews/2.jpg)

![image](previews/3.jpg)

![image](previews/4.jpg)

## Building from source

If you cannot open `SfPlayer.exe` on your current pc and system, you can try to compile from source. Here are the steps.

1. install python >= 3.7
2. open cmd, run `pip install pyqt5, sf2_loader, dataclasses, pyinstaller`
3. copy and paste the file `player start program.pyw` from `SfPlayer-main/packages` folder to `SfPlayer-main` folder, change the line `abs_path = os.path.dirname(os.path.abspath(__file__))` to `abs_path = os.path.dirname(sys.executable)`
4. under `SfPlayer-main` folder, open cmd, run `pyinstaller -w -F "player start program.pyw" --hidden-import dataclasses` to start creating executable
5. when the compiling is finished, go to `SfPlayer-main/dist` folder, you will see an executable file there, rename it to `SfPlayer.exe`, copy and paste the exe file to SfPlayer-main folder, replacing the old exe file
6. now you can open the new exe file to open the software

## Donation

This project is developed by Rainbow Dreamer on his spare time. If you feel this project is useful to you and want to support it and it's future development, please consider buy me a coffee, I appreciate any amount.

[![Support via PayPal](https://cdn.rawgit.com/twolfson/paypal-github-button/1.0.0/dist/button.svg)](https://www.paypal.com/donate/?business=7XSUZCQNT4M4Y&no_recurring=0&currency_code=CAD)