Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arbitrarycombination/fluidsynthunity
FluidSynth core ported to C# with Unity bindings
https://github.com/arbitrarycombination/fluidsynthunity
fluidsynth midi unity3d unity3d-plugin
Last synced: 7 days ago
JSON representation
FluidSynth core ported to C# with Unity bindings
- Host: GitHub
- URL: https://github.com/arbitrarycombination/fluidsynthunity
- Owner: ArbitraryCombination
- License: lgpl-2.1
- Created: 2023-08-16T08:08:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-08-16T12:02:16.000Z (over 1 year ago)
- Last Synced: 2024-11-10T13:52:05.864Z (about 2 months ago)
- Topics: fluidsynth, midi, unity3d, unity3d-plugin
- Language: C#
- Homepage: https://omnibullet.cz/
- Size: 5.31 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE~/fluidsynth.txt
Awesome Lists containing this project
README
# FluidSynth Unity
[FluidSynth](https://www.fluidsynth.org/) ported to C# through
[Midi Player Tool Kit (Unity Asset)](https://assetstore.unity.com/packages/tools/audio/maestro-midi-player-tool-kit-free-107994) with Unity bindings.
Comes with [NVorbis](https://github.com/NVorbis/NVorbis) OGG Vorbis decoder.
All parts are heavily modified: stripped down and optimized.
Stripping down relates to playing MIDI files, stereo sound and other features that were not needed for Omnibullet.
The goal was to optimize performance and the binary size.
This allows the system to load the whole sound font under 1ms, keep the memory usage down and work with good latency.
(Although if you want a good latency, you may need to get creative with the API:
The toy API used in the sample example project uses Unity's `OnAudioFilterRead` which has
terrible latency. Omnibullet uses a different approach based on dynamically generated `AudioClip`s to reach near zero latency.)
## How to use
See the samples. This is not a plug and play package, you may still need to do some coding.
## Install
Open `Packages/manifest.json` with your favorite text editor. Add following line to the dependencies block:
```json
{
"dependencies": {
"cz.omnibullet.fluidsynth-unity": "https://github.com/ArbitraryCombination/FluidSynthUnity.git"
}
}
```
## License
The project builds upon multiple separately licensed components:
- [FluidSynth](https://github.com/FluidSynth/fluidsynth)
- [LGPL 2.1 License](LICENSE~/fluidsynth.txt)
- Copyright © 2022 FluidSynth contributors
- [NVorbis](https://github.com/NVorbis/NVorbis)
- [MIT License](LICENSE~/nvorbis.txt)
- Copyright © 2020 Andrew Ward
- [GeneralUser GS sound font](https://www.schristiancollins.com/generaluser.php)
- [GeneralUser GS v1.44 License v2.0](LICENSE~/generalusergs.txt)
- [Maestro - Midi Player Tool Kit - Free](https://assetstore.unity.com/packages/tools/audio/maestro-midi-player-tool-kit-free-107994)
- [Asset Store Terms of Service](https://unity.com/legal/as-terms) - since this adds a "substantial amount of original creative work developed or licensed outside of the Asset Store" ([FAQ](https://assetstore.unity.com/browse/eula-faq)), I guess this is ok?
- The modifications and additions performed as part of this package
- [Zero-Clause BSD License](https://opensource.org/license/0bsd/)
- Copyright © 2022-2023 Arbitrary Combination
Note that while the modifications are under 0BSD,
you still must follow the terms and conditions of other licenses.
## Contributing
1. Fork this repository (For further details, see https://docs.github.com/en/github/getting-started-with-github/fork-a-repo)
2. Develop changes to a new branch to your forked repository
3. Create a Pull Request from your forked repository against this repository
- Pull request description should answer these questions: "What has been changed" and "What is this for"
### Developing
One way to develop this Unity package is to create a new Unity Project and copy this package to its Assets folder.
This way .meta files (required by Unity) are generated automatically. Assets available in the package can now be tested and developed inside the project.
After making changes you can test your package by eg. installing it via Git URL:
Open `Packages/manifest.json` with your favorite text editor. Add following line to the dependencies block:
```json
{
"dependencies": {
"com.arbitrary-combination.FluidSynthUnity": "https://github.com/ArbitraryCombination/FluidSynthUnity.git"
}
}
```
For further details, see [Unity docs about custom packages](https://docs.unity3d.com/Manual/CustomPackages.html).