zdoom/fluidsynth
0
0
Fork 0
mirror of https://github.com/ZDoom/fluidsynth.git synced 2024-11-13 00:04:10 +00:00
Code Issues Projects Releases Packages Wiki Activity
Software synthesizer based on the SoundFont 2 specifications
1816 commits 10 branches 46 tags 9.2 MiB
C 92.2%
CMake 5.6%
C++ 1.1%
Shell 0.9%
Find a file
Florian Léger 099369f8b7 Improve systemd integration 
When fluidsynth is run as a service using systemd, make sure
the service is considered started only when it is ready to process events.

In order to do so:
 - Add an optional runtime dependency to libsystemd to the fluidsynth executable
 - Change the systemd service type to "notify"
 - Have fluidsynth notify systemd that the service is started after the server is started
 - Have fluidsynth notify systemd that the service is stopping after joining the server thread
2019-03-02 10:18:32 +01:00
.github update issue_template.md 2018-09-03 21:08:34 +02:00
cmake_admin Improve systemd integration 2019-03-02 10:18:32 +01:00
doc bump to 2.0.4 2019-02-08 17:39:12 +01:00
include fix documentation of fluid_sfont_iteration_next_t 2018-12-26 21:03:59 +01:00
sf2 Add VintageDreamsWaves-v2 in SF3 format and some tests for sf3 loading 2018-04-18 09:14:55 +02:00
src Improve systemd integration 2019-03-02 10:18:32 +01:00
test fix building CoreAudio on OSX 10.4 2019-02-15 17:55:02 +01:00
.appveyor-mingw.yml Add MinGW to AppVeyor CI (#515) 2019-02-22 10:08:02 +01:00
.appveyor-vcpkg.yml Optimize Travis and AppVeyor CI builds (#451) 2018-10-28 16:29:15 +01:00
.appveyor.yml Add MinGW to AppVeyor CI (#515) 2019-02-22 10:08:02 +01:00
.cirrus.yml add circleCI for FreeBSD builds 2019-02-08 20:01:41 +01:00
.clang-format cmake: setup formatting targets 2018-06-24 12:59:46 +02:00
.clang-tidy clang-tidy: remove annoying readability-inconsistent-declaration-parameter-name 2018-10-28 14:21:36 +01:00
.gitignore add gitignore 2017-09-23 18:17:40 +02:00
.travis.yml travis: disable sudo 2018-10-31 13:23:05 +01:00
AUTHORS Update polymono doc and AUTHORS files (#428) 2018-09-12 12:10:29 +02:00
ChangeLog remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
CMakeLists.txt Improve systemd integration 2019-03-02 10:18:32 +01:00
CONTRIBUTING.md add style guide related notes to CONTRIBUTING.md 2018-03-24 14:35:52 +01:00
fluidsynth.conf.in add systemd service files 2018-02-20 21:31:35 +01:00
fluidsynth.pc.in remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
fluidsynth.service.in Improve systemd integration 2019-03-02 10:18:32 +01:00
fluidsynth.spec.in remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
LICENSE move README and LICENSE to top-level dir 2017-07-27 12:11:26 +02:00
NEWS remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
README-OSX update READMEs 2018-06-15 18:38:21 +02:00
README.cmake.md Update and rename README.cmake to README.cmake.md 2018-06-15 17:47:12 +02:00
README.md add MinGW build badge to ReadMe 2019-02-22 10:10:53 +01:00
THANKS remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
TODO cleanup TODO 2018-08-16 11:06:11 +02:00

README.md

FluidSynth

Build Status glib < 2.30 glib >= 2.30
Linux/MacOSX n.a. Build Status Travis
FreeBSD n.a. Build Status
Windows (VisualStudio) Build status Appveyor Build status
Windows (MinGW) Build status n.a.

FluidSynth is a software real-time synthesizer based on the Soundfont 2 specifications.

OHLOH Project Stats

FluidSynth reads and handles MIDI events from the MIDI input device. It is the software analogue of a MIDI synthesizer. FluidSynth can also play midifiles using a Soundfont.

Information on the web

The place to look if you are looking for the latest information on FluidSynth is the web site at http://www.fluidsynth.org/.

For documentation, please see the links below.

For information on how to build FluidSynth from source, please see our wiki page.

Why did we do it

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 standard combined with an intelligent use of midifiles. The arguments were:

  • Wave table synthesis is low on CPU usage, it is intuitive and it can 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.

Design decisions

The synthesizer was designed to be as self-contained as possible for several reasons:

  • It had to be multi-platform (Linux, MacOS, Win32). It was therefore important that the code didn't rely on any platform specific library.

  • It had to be easy to integrate the synthesizer modules in various environements, as a plugin or as a dynamically loadable object. I 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 if the project stayed very focussed on it's goal (a Soundfont synthesizer), stayed small (ideally one file) and didn't dependent on external code.

Links

Home Page

Documentation

Software SoundFont Synthesizers:

Soundfont Editors

Conversion Tools

Soundfont Databases