sfizz/README.md

112 lines
6.2 KiB
Markdown
Raw Normal View History

2019-09-08 18:19:43 +02:00
# sfizz
2019-09-09 12:18:01 +02:00
[![Travis Build Status]](https://travis-ci.com/sfztools/sfizz)
2020-02-27 07:04:43 +01:00
[![AppVeyor Build Status]](https://ci.appveyor.com/project/sfztools/sfizz)
2020-02-12 16:13:47 +10:30
[![Discord Badge Image]](https://discord.gg/3ArE9Mw)
2021-06-22 02:50:19 +02:00
[![SFZv1 Status Image]](https://sfz.tools/sfizz/development/status/opcodes/?v=1)
[![SFZv2 Status Image]](https://sfz.tools/sfizz/development/status/opcodes/?v=2)
[![ARIA Status Image]](https://sfz.tools/sfizz/development/status/opcodes/?v=aria)
[![Cakewalk Status Image]](https://sfz.tools/sfizz/development/status/opcodes/?v=cakewalk)
SFZ parser and synth c++ library, providing AU / LV2 / VST3 plugins
and JACK standalone client, please check [our website] for more details.
2019-09-18 09:13:36 +02:00
![Screenshot](screenshot.png)
2019-12-24 21:50:59 +01:00
2020-07-15 23:53:21 +02:00
## Using sfizz
Sfizz can be used most easily within an LV2 host such as [Carla] or [Ardour].
It can also be integrated as a library within your own program; check out our [API] bindings for C and C++.
2021-11-25 22:15:49 +01:00
Our [releases] are an immediate way to get a working library or LV2/VST plugin for Windows and Mac.
Linux builds are available over at [OBS].
On any operating system, you might prefer to [build from source]!
2020-07-15 23:53:21 +02:00
## Contributing to sfizz
There is actually many things anyone can do, programming-related or music-related.
2020-07-16 00:17:41 +02:00
Please check out the [CONTRIBUTING](CONTRIBUTING.md) document for information about filing bug reports or feature requests, and helping the development of sfizz
2020-07-15 23:53:21 +02:00
## Donating to sfizz
Sfizz and the work in the SFZ tools organization is purely driven by hobbyists who choose to use their free time to benefit this project.
We firmly believe in the honesty and goodwill of users as a whole, and we want to promote a healthy relationship to software and to the cost of producing quality software.
No financial returns is explicitely required from using sfizz in any shape.
However, if you feel that sfizz produces value for you or your products, and if you find that your financial situation allows for it, we put together ways to donate to the project.
2020-07-16 00:17:41 +02:00
You are never compelled to do so, the [CONTRIBUTING](CONTRIBUTING.md) file contains different ways to contribute.
2020-07-15 23:53:21 +02:00
In all of sfizz's governance model, we strive to live in the open.
Finances are no different, and we put in place a process so that the use of donations is as transparent as possible through our [Open Collective].
2020-07-16 00:17:41 +02:00
We invite you to check out the [GOVERNANCE](GOVERNANCE.md) file to see how the organization is governed and how are donations handled.
2020-07-15 23:53:21 +02:00
## Dependencies and licenses
2020-01-25 13:52:34 +01:00
2021-04-17 11:21:22 +02:00
The sfizz library has the option to be compiled against either the `dr_libs`
audio libraries, which is now the default option, or `libsndfile`.
- [dr_libs] is licensed under the MIT No Attribution license
- [libsndfile] is licensed under the GNU Lesser General Public License v2.1
2020-01-25 13:52:34 +01:00
The sfizz library makes primary use of:
2021-04-03 13:40:50 +02:00
- [Abseil], licensed under the Apache License 2.0
- [atomic_queue] by Maxim Egorushkin, licensed under the MIT license
- [filesystem] by Steffen Schümann, licensed under the BSD 3-Clause license
- [hiir] by Laurent de Soras, licensed under the WTFPL v2 license
2021-02-01 14:12:56 +01:00
- [KISS FFT] by Mark Borgerding, licensed under the BSD 3-Clause license
- [Surge tuning] by Paul Walker, licensed under the MIT license
- [pugixml] by Arseny Kapoulkine, licensed under the MIT license
- [cephes] by Stephen Moshier, licensed under the BSD 3-Clause license
- [cpuid] by Steinwurf ApS, licensed under the BSD 3-Clause license
2021-04-15 21:37:10 +02:00
- [faust-libraries] by GRAME, Julius O. Smith III and Eric Tarr, licensed under the STK-4.3 license and a permissive variant of the LGPL license
2020-01-25 13:52:34 +01:00
The sfizz library also uses in some subprojects:
2021-04-03 13:40:50 +02:00
- [Catch2], licensed under the Boost Software License 1.0
- [benchmark], licensed under the Apache License 2.0
- [LV2], licensed under the ISC license
- [JACK], licensed under the GNU Lesser General Public License v2.1
2021-02-01 14:12:56 +01:00
- [cxxopts] by Jarryd Beck, licensed under the MIT license
- [fmidi] by Jean Pierre Cimalando, licensed under the Boost Software License 1.0
- [libsamplerate], licensed under the BSD 2-Clause license
- [GLSL-Color-Spaces] by tobspr, licensed under the MIT license
2021-04-03 13:40:50 +02:00
- [stb_image] by Sean Barrett, licensed as public domain or MIT license
2021-02-01 14:12:56 +01:00
[Abseil]: https://abseil.io/
[atomic_queue]: https://github.com/max0x7ba/atomic_queue
[benchmark]: https://github.com/google/benchmark
[Catch2]: https://github.com/catchorg/Catch2
[filesystem]: https://github.com/gulrak/filesystem
2021-02-01 14:12:56 +01:00
[Surge tuning]: https://surge-synth-team.org/tuning-library/
[pugixml]: https://pugixml.org/
[cephes]: https://www.netlib.org/cephes/
[cpuid]: https://github.com/steinwurf/cpuid
2021-04-17 11:27:15 +02:00
[dr_libs]: https://github.com/mackron/dr_libs
2021-04-15 21:37:10 +02:00
[faust-libraries]: https://github.com/grame-cncm/faustlibraries
[hiir]: http://ldesoras.free.fr/prod.html#src_hiir
2021-02-01 14:12:56 +01:00
[KISS FFT]: http://kissfft.sourceforge.net/
[JACK]: https://github.com/jackaudio/jack2
2021-02-01 14:12:56 +01:00
[cxxopts]: https://github.com/jarro2783/cxxopts
[fmidi]: https://github.com/jpcima/fmidi
[libsamplerate]: http://www.mega-nerd.com/SRC/
[libsndfile]: http://www.mega-nerd.com/libsndfile/
[LV2]: https://lv2plug.in/
[GLSL-Color-Spaces]: https://github.com/tobspr/GLSL-Color-Spaces
[stb_image]: https://github.com/nothings/stb
[our website]: https://sfz.tools/sfizz
2020-07-15 23:53:21 +02:00
[releases]: https://github.com/sfztools/sfizz/releases
[Carla]: https://kx.studio/Applications:Carla
[Ardour]: https://ardour.org/
[API]: https://sfz.tools/sfizz/api/
[Open Collective]: https://opencollective.com/sfztools
[build from source]: https://sfz.tools/sfizz/development/build/
2020-02-27 07:04:43 +01:00
[AppVeyor Build Status]: https://img.shields.io/appveyor/ci/sfztools/sfizz.svg?label=Windows&style=popout&logo=appveyor
[Travis Build Status]: https://img.shields.io/travis/com/sfztools/sfizz.svg?label=Linux&style=popout&logo=travis
[Discord Badge Image]: https://img.shields.io/discord/587748534321807416?label=discord&logo=discord
2021-11-25 22:15:49 +01:00
[OBS]: https://software.opensuse.org//download.html?project=home%3Asfztools%3Asfizz&package=sfizz
2021-06-22 02:50:19 +02:00
[SFZv1 Status Image]: https://sfz.tools/assets/img/sfizz/badge_sfz1.svg
[SFZv2 Status Image]: https://sfz.tools/assets/img/sfizz/badge_sfz2.svg
[ARIA Status Image]: https://sfz.tools/assets/img/sfizz/badge_aria.svg
[Cakewalk Status Image]: https://sfz.tools/assets/img/sfizz/badge_cakewalk.svg