2017-11-15 13:52:04 +00:00
# FluidSynth
2020-04-08 09:13:42 +00:00
| | Build Status |
|---|---|
2021-02-07 13:10:25 +00:00
| < img src = "https://www.kernel.org/theme/images/logos/tux.png" height = "30" alt = "" > **Linux** | [](https://github.com/FluidSynth/fluidsynth/actions?query=workflow%3A%22FluidSynth+Linux%22) |
2020-04-08 09:13:42 +00:00
| < img src = "https://cdn.pling.com/img//hive/content-pre1/112422-1.png" height = "25" alt = "" > **FreeBSD** | [](https://cirrus-ci.com/github/FluidSynth/fluidsynth) |
| < img src = "https://www.microsoft.com/windows/favicon.ico" height = "25" alt = "" > **Windows** | [](https://dev.azure.com/tommbrt/tommbrt/_build/latest?definitionId=3& branchName=master) |
2020-12-29 18:35:04 +00:00
| < img src = "https://www.microsoft.com/windows/favicon.ico" height = "25" alt = "" > **Windows (vcpkg)** | [](https://dev.azure.com/tommbrt/tommbrt/_build/latest?definitionId=6& branchName=master) |
2020-04-08 09:13:42 +00:00
| < img src = "https://www.apple.com/favicon.ico" height = "30" alt = "" > **MacOSX** | [](https://dev.azure.com/tommbrt/tommbrt/_build/latest?definitionId=5& branchName=master) |
2021-05-08 16:31:20 +00:00
| < img src = "https://www.android.com/favicon.ico" height = "30" alt = "" > **Android** | [](https://dev.azure.com/tommbrt/tommbrt/_build/latest?definitionId=4& branchName=master) |
| < img src = "https://www.android.com/favicon.ico" height = "30" alt = "" > **Android** (legacy Cerbero) | [](https://circleci.com/gh/FluidSynth/fluidsynth) |
2019-10-20 21:09:23 +00:00
2019-10-13 08:56:24 +00:00
2017-11-15 13:52:04 +00:00
2019-10-13 08:56:24 +00:00
#### FluidSynth is a cross-platform, real-time software synthesizer based on the Soundfont 2 specification.
FluidSynth generates audio by reading and handling MIDI events from MIDI input devices by using a [SoundFont ](https://github.com/FluidSynth/fluidsynth/wiki/SoundFont ). It is the software analogue of a MIDI synthesizer. FluidSynth can also play MIDI files.
2017-11-15 13:52:04 +00:00
2020-09-08 14:33:57 +00:00
[](https://sonarcloud.io/dashboard?id=FluidSynth_fluidsynth) [](https://lgtm.com/projects/g/FluidSynth/fluidsynth/context:cpp) [](https://www.openhub.net/p/fluidsynth)
2003-03-11 16:56:45 +00:00
2019-10-13 08:56:24 +00:00
## Documentation
The central place for documentation and further links is our **wiki** here at GitHub:
2020-04-08 09:13:42 +00:00
#### https://github.com/FluidSynth/fluidsynth/wiki
2019-10-13 08:56:24 +00:00
If you are missing parts of the documentation, let us know by writing to our mailing list.
Of course, you are welcome to edit and improve the wiki yourself. All you need is an account at GitHub. Alternatively, you may send an EMail to our mailing list along with your suggested changes. Further information about the mailing list is available in the wiki as well.
2021-03-08 15:46:36 +00:00
Latest information about FluidSynth is also available on the web site at https://www.fluidsynth.org/.
2003-03-11 16:56:45 +00:00
2019-10-13 08:56:24 +00:00
## License
2003-03-11 16:56:45 +00:00
2019-10-13 08:56:24 +00:00
The source code for FluidSynth is distributed under the terms of the [GNU Lesser General Public License ](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html ), see the [LICENSE ](https://github.com/FluidSynth/fluidsynth/blob/master/LICENSE ) file. To better understand the conditions how FluidSynth can be used in e.g. commercial or closed-source projects, please refer to the [LicensingFAQ in our wiki ](https://github.com/FluidSynth/fluidsynth/wiki/LicensingFAQ ).
2003-03-11 16:56:45 +00:00
2019-10-13 08:56:24 +00:00
## Building from source
For information on how to build FluidSynth from source, please [refer to our wiki ](https://github.com/FluidSynth/fluidsynth/wiki/BuildingWithCMake ).
## Links
2021-03-08 15:46:36 +00:00
- FluidSynth's Home Page, https://www.fluidsynth.org
2019-10-13 08:56:24 +00:00
- FluidSynth's wiki, https://github.com/FluidSynth/fluidsynth/wiki
2003-03-11 16:56:45 +00:00
2021-03-08 15:46:36 +00:00
- FluidSynth's API documentation, https://www.fluidsynth.org/api/
2018-06-15 16:38:21 +00:00
2019-10-13 08:56:24 +00:00
---
2018-06-15 16:38:21 +00:00
2019-10-13 08:56:24 +00:00
## Historical background
2003-03-11 16:56:45 +00:00
2019-10-13 08:56:24 +00:00
### Why did we do it
2003-03-11 16:56:45 +00:00
The synthesizer grew out of a project, started by Samuel Bianchini and
Peter Hanappe, and later joined by Johnathan Lee, that aimed at
developing a networked multi-user game.
Sound (and music) was considered a very important part of the game. In
addition, users had to be able to extend the game with their own
sounds and images. Johnathan Lee proposed to use the Soundfont
2019-10-13 08:56:24 +00:00
standard combined with intelligent use of midifiles. The arguments
2003-03-11 16:56:45 +00:00
were:
2019-10-13 08:56:24 +00:00
- Wavetable synthesis is low on CPU usage, it is intuitive and it can
2003-03-11 16:56:45 +00:00
produce rich sounds
- Hardware acceleration is possible if the user owns a Soundfont
compatible soundcard (important for games!)
- MIDI files are small and Soundfont2 files can be made small thru the
intelligent use of loops and wavetables. Together, they are easier to
downloaded than MP3 or audio files.
- Graphical editors are available for both file format: various
Soundfont editors are available on PC and on Linux (Smurf!), and
MIDI sequencers are available on all platforms.
It seemed like a good combination to use for an (online) game.
In order to make Soundfonts available on all platforms (Linux, Mac,
and Windows) and for all sound cards, we needed a software Soundfont
synthesizer. That is why we developed FluidSynth.
2019-10-13 08:56:24 +00:00
### Design decisions
2003-03-11 16:56:45 +00:00
The synthesizer was designed to be as self-contained as possible for
several reasons:
2019-10-13 08:56:24 +00:00
- It had to be multi-platform (Linux, macOS, Win32). It was therefore
important that the code didn't rely on any platform-specific
2003-03-11 16:56:45 +00:00
library.
- It had to be easy to integrate the synthesizer modules in various
2019-10-13 08:56:24 +00:00
environments, as a plugin or as a dynamically loadable object. I
2003-03-11 16:56:45 +00:00
wanted to make the synthesizer available as a plugin (jMax, LADSPA,
Xmms, WinAmp, Director, ...); develop language bindings (Python,
Java, Perl, ...); and integrate it into (game) frameworks (Crystal
Space, SDL, ...). For these reasons I've decided it would be easiest
2019-12-17 16:41:30 +00:00
if the project stayed very focused on its goal (a Soundfont
2003-03-11 16:56:45 +00:00
synthesizer), stayed small (ideally one file) and didn't dependent
on external code.
