{"id":29774130,"url":"https://github.com/lsp-plugins/lsp-plugins","last_synced_at":"2026-04-02T21:11:26.312Z","repository":{"id":37623012,"uuid":"140602476","full_name":"lsp-plugins/lsp-plugins","owner":"lsp-plugins","description":"Linux Studio Plugins Project","archived":false,"fork":false,"pushed_at":"2026-03-09T01:08:49.000Z","size":111808,"stargazers_count":773,"open_issues_count":69,"forks_count":63,"subscribers_count":21,"default_branch":"master","last_synced_at":"2026-03-09T06:40:27.584Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://lsp-plug.in/","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lsp-plugins.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"liberapay":"sadko4u","patreon":"sadko4u","custom":["https://www.blockchain.com/btc/address/15X3AfDRF3EshSLBoK8UfHAsFr2TQsH8pk","https://etherscan.io/address/0x079b24da78d78302cd3cfbb80c728cd554606cc6","https://www.bountysource.com/teams/lsp-plugins","https://paypal.me/sadko4u"]}},"created_at":"2018-07-11T16:33:12.000Z","updated_at":"2026-03-06T14:56:11.000Z","dependencies_parsed_at":"2023-10-14T22:07:15.443Z","dependency_job_id":"7e57cae8-b4a5-4ac7-8272-ee9722ef18ef","html_url":"https://github.com/lsp-plugins/lsp-plugins","commit_stats":null,"previous_names":["sadko4u/lsp-plugins"],"tags_count":108,"template":false,"template_full_name":null,"purl":"pkg:github/lsp-plugins/lsp-plugins","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsp-plugins%2Flsp-plugins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsp-plugins%2Flsp-plugins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsp-plugins%2Flsp-plugins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsp-plugins%2Flsp-plugins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lsp-plugins","download_url":"https://codeload.github.com/lsp-plugins/lsp-plugins/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lsp-plugins%2Flsp-plugins/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30407285,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-11T22:36:59.286Z","status":"ssl_error","status_checked_at":"2026-03-11T22:36:57.544Z","response_time":84,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-27T08:01:40.283Z","updated_at":"2026-04-02T21:11:26.284Z","avatar_url":"https://github.com/lsp-plugins.png","language":"Makefile","funding_links":["https://liberapay.com/sadko4u","https://patreon.com/sadko4u","https://www.blockchain.com/btc/address/15X3AfDRF3EshSLBoK8UfHAsFr2TQsH8pk","https://etherscan.io/address/0x079b24da78d78302cd3cfbb80c728cd554606cc6","https://www.bountysource.com/teams/lsp-plugins","https://paypal.me/sadko4u","https://liberapay.com/sadko4u/donate","https://www.patreon.com/sadko4u"],"categories":["Makefile"],"sub_categories":[],"readme":"# ABOUT\n\nLSP (Linux Studio Plugins) is a collection of open-source plugins\ncurrently compatible with CLAP, LADSPA, LV2, VST2/LinuxVST, VST3\nand JACK standalone formats.\n\nThe basic idea is to fill the lack of good and useful plugins under\nthe GNU/Linux platform.\n\nAfter some contributions to other open source projects the decision\nwas made to implement separate and independent plugin distribution.\n\nAll supplementary information you will find on official web site:\n  https://lsp-plug.in/\n\nNote that after 1.2.0 release the lsp-plugins repository was decomposed\ninto multiple subprojects. As a result, it is the repository without any code\nand for build purposes it gathers source code as dependencies from another\nrepositories which are located here:\n  https://github.com/lsp-plugins/\n\n# LICENSING\n\nThe LSP project is an open-source project and cares about quality of\ndeveloped software.\n\nStill there is no absolute warranty about stability of the software on\ndifferent platforms so you're using this software on your own risk.\n\nThe project also does encourage donations that can be submitted here:\n  * https://liberapay.com/sadko4u/donate\n  * https://www.patreon.com/sadko4u\n  * https://paypal.me/sadko4u\n  * https://etherscan.io/address/0x079b24da78d78302cd3cfbb80c728cd554606cc6\n  * https://salt.bountysource.com/teams/lsp-plugins\n\nLicensed under the terms of GNU Lesser Public License v3 (LGPLv3):\n  * https://www.gnu.org/licenses/lgpl-3.0.en.html\n\nFor more information about licensing, please read COPYING and COPYING.LESSER.\n\n# SYSTEM REQUIREMENTS\n\nCurrent matrix of hardware architecture and platform (OS) support is:\n\n```\n  ┌───────────┬───────────┬─────────┬─────────┬─────────┐\n  │Arch / OS  │ GNU/Linux │ FreeBSD │ Windows │  macOS  |\n  ╞═══════════╪═══════════╪═════════╪═════════╪═════════╡\n  │aarch64    │     F     │    E    │    U    │    E    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │armv5t     │     C     │    C    │    U    │    N    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │armv6-a    │     E     │    E    │    U    │    N    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │armv7-ar   │     E     │    E    │    U    │    N    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │i586       │     F     │    F    │    E    │    N    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │loongarch32│     C     │    U    │    U    │    N    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │loongarch64│     C     │    U    │    U    │    N    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │ppc64      │     C     │    U    │    U    │    N    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │riscv-64   │     C     │    U    │    U    │    N    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │s390x      │     C     │    U    │    U    │    N    │\n  ├───────────┼───────────┼─────────┼─────────┼─────────┤\n  │x86_64     │     F     │    F    │    E    │    U    │\n  └───────────┴───────────┴─────────┴─────────┴─────────┘\n```\n\nThe table legend is the following:\n * F - Full support.\n * C - The code does compile, not enough knowledge about it's correct work.\n * E - Experimental support, not enough feedback from users.\n * U - Unknown, the code may be built but the correctness of it's work has not been tested.\n * N - No support, the code may compile but the work has not been tested.\n\n\nNote that minimum supported Windows version is Windows Vista.\n\nSupported plugin formats:\n  * CLAP (full support);\n  * GStreamer (experimental support);\n  * JACK standalone (full support)\n  * LADSPA (partial support: not supported by plugins that use MIDI or file loading due to LADSPA plugin format restrictions);\n  * LV2 (full support);\n  * VST2/LinuxVST (full support);\n  * VST3 (full support).\n\nThe Linux distribution requirements:\n  * glibc \u003e= 2.19\n  * libsndfile \u003e= 1.0.25\n  * libcairo \u003e= 1.14\n  * libfreetype \u003e= 2.10\n  * libGL\n\nKnown list of supported plugin hosts:\n  * Ardour\n  * Bitwig Studio\n  * Carla\n  * Mixbus\n  * Qtractor\n  * Reaper\n  * Renoise\n  * Tracktion\n\n# VERSIONING\n\nBinary releases contain all possible plugins in one bundle. The binaries are packaged\ninto archive named according to the following format:\n\n```\n  lsp-plugins-\u003cformat\u003e-\u003cmajor\u003e.\u003cminor\u003e.\u003cmicro\u003e-\u003cplatform\u003e-\u003carch\u003e.tar.gz\n```\n\nThe property \u003cformat\u003e is the format of plugins, currently available:\n  * clap - plugins in [CLAP](https://github.com/free-audio/clap) format;\n  * doc - documentation;\n  * gst - plugins in [GStreamer](https://gstreamer.freedesktop.org/) format;\n  * jack - standalone version of plugins that require [JACK](https://jackaudio.org/) server for execution;\n  * ladspa - plugins in [LADSPA](https://en.wikipedia.org/wiki/LADSPA) format (not all plugins due to format's restriction);\n  * lv2 - plugins in [LV2](https://lv2plug.in/) format;\n  * src - source code;\n  * vst2 - plugins in [VST 2.4](https://www.steinberg.net/) format;\n  * vst3 - plugins in [VST3](https://www.steinberg.net/) format.\n\nProperty 'arch' contains short name of architecture the binaries are build for.\nProperties 'major', 'minor' and 'micro' form the version of release.\nIf the \u003cmicro\u003e version is odd, it contains mostly bug-fixes and patches for\nthe plugin modules. The even 'micro' version of plugins contains new features\nand, in most cases, new plugin series. The history of changes may be seen in\nattached CHANGELOG.txt.\n\nSource code is also ready for building, see 'BUILDING' section for details.\n\n# INSTALLATION\n\nBinary distributions are ready to launch, just copy them to the appropriate directory.\n\nReleases containing odd number in minor version provide only enhancements\nand critical fixes for the previous release.\n\nIMPORTANT FOR VST INSTALLATIONS: If you deploy plugins as a subdirectory\nof your VST2 directory, the subdirectory should contain substring\n'lsp-plugins'. Otherwise plugins won't find the VST2 core library.\nPlease notice that '~' means user's home directory.\n\n## For Linux/FreeBSD\n\nThe usual directories for CLAP are:\n  * /usr/lib/clap\n  * /usr/local/lib/clap\n  * /usr/lib64/clap\n  * /usr/local/lib64/clap\n  * ~/.clap\n\nThe usual directories for JACK core library are:\n  * /usr/lib\n  * /usr/local/lib\n  * /lib\n  * /usr/lib64\n  * /usr/local/lib64\n  * /lib64\n\nThe usual directories for JACK binaries are:\n  * /usr/bin\n  * /usr/local/bin\n  * /bin\n  * /usr/sbin\n  * /usr/local/sbin\n  * /sbin\n\nThe usual directories for GStreamer core library:\n  * /usr/lib\n  * /usr/local/lib\n  * /lib\n  * /usr/lib64\n  * /usr/local/lib64\n  * /lib64\n\nThe usual installation directory for GStreamer plugins can be obtained by the following command:\n\n```bash\npkg-config --variable=pluginsdir gstreamer-1.0\n```\n\nThe usual directories are the following:\n  * /usr/lib64/gstreamer-1.0\n  * /usr/lib/gstreamer-1.0\n  * /usr/local/lib64/gstreamer-1.0\n  * /usr/local/lib/gstreamer-1.0\n\nThe usual directories for LADSPA are:\n  * /usr/lib/ladspa\n  * /usr/local/lib/ladspa\n  * /usr/lib64/ladspa\n  * /usr/local/lib64/ladspa\n  * ~/.ladspa\n\nThe usual directories for LV2 are:\n  * /usr/lib/lv2\n  * /usr/local/lib/lv2\n  * /usr/lib64/lv2\n  * /usr/local/lib64/lv2\n  * ~/.lv2\n\nThe usual directories for VST 2.x/LinuxVST are:\n  * /usr/lib/vst\n  * /usr/local/lib/vst\n  * /usr/lib64/vst\n  * /usr/local/lib64/vst\n  * ~/.lxvst\n  * ~/.vst\n\nThe usual directories for VST 3.x are:\n  * /usr/lib/vst3\n  * /usr/local/lib/vst3\n  * /usr/lib64/vst3\n  * /usr/local/lib64/vst3\n  * ~/.vst3\n\n## For Windows\n\nThe usual directory for LV2 binaries is:\n  * C:\\Program Files\\Common Files\\LV2\n\nThe usual directory for VST2 binaries is:\n  * C:\\Program Files\\Common Files\\VST\n\nThe usual directory for VST3 binaries is:\n  * C:\\Program Files\\Common Files\\VST3\n  * C:\\Program Files (x86)\\Common Files\\VST3 - for 32-bit plugins on 64-bit Windows.\n\nThe usual directory for CLAP binaries is:\n  * C:\\Program Files\\Common Files\\CLAP\n\n## For macOS\n\nThe usual directory for LV2 binaries is:\n  * /usr/local/lib/lv2\n\n# BUILDING\n\nYou may build plugins from scratch.\n\nThe build process doesn't differ much for GNU/Linux, FreeBSD or Windows.\nFor a build on macOS and FreeBSD you should use `gmake` instead of `make`.\nBuild of JACK standalone versions for Windows is yet not supported.\n\nFor successful build for Linux/FreeBSD you need the following packages to be installed:\n  * gcc \u003e= 4.7 OR clang \u003e= 10.0.1\n  * gcc-c++ \u003e= 4.7 OR clang-c++ \u003e= 10.0.1\n  * libgcc_s1 \u003e= 5.2\n  * libstdc++-devel \u003e= 4.7\n  * libsndfile-devel \u003e= 1.0.25\n  * libcairo-devel \u003e= 1.14\n  * php \u003e= 5.5.14 (for documentation)\n  * jack-devel \u003e= 1.9.5 (for JACK)\n  * libiconv (for FreeBSD)\n  * libGL-devel \u003e= 11.2.2\n  * gstreamer \u003e= 1.20 (for GStreamer)\n  * gstreamer-plugins-base \u003e= 1.20 (for GStreamer)\n\nFor macOS build, the following software needs to be installed:\n  * make \u003e= 4.4.1\n  * cairo \u003e= 1.18.4\n  * freetype \u003e= 2.13.3\n  * pkgconf \u003e= 2.5.1\n  * php \u003e= 5.5.14 (for the docs)\n\nFor Windows build, the following software needs to be installed:\n  * MinGW/MinGW-W64 \u003e= 7.0\n  * Git \u003e= 2.8 (optional)\n  * PHP \u003e= 5.5.14\n  * GNU Make \u003e= 4.2\n\nTo perform toolchain setup for Windows, you may perform the following steps:\n  * Download [latest Git](https://git-scm.com/download/win)\n  * Download [latest MinGW-W64 GCC](https://sourceforge.net/projects/mingw-w64/files/mingw-w64/)\n  * Download [latest PHP x64 Thread Safe ZIP package](https://windows.php.net/download/)\n  * Install Git\n  * Unpack PHP ZIP to C:\\php\n  * Unpack MinGW to C:\\mingw64\n  * To make all installed software accessible from command line, add to the PATH environment variable following elements:\n    * C:\\Program Files\\Git\\cmd\n    * C:\\Program Files\\Git\\usr\\bin\n    * C:\\mingw64\\bin\n    * C:\\php\n\n\u003e MacOS includes their own version of `make`, if you decide to install it from homebrew, replace all the commands with `gmake`.\n\nTo build the project from archive with source code, the following sequence of commands\nshould be performed:\n\n```\n  make clean\n  make config\n  make\n  make install\n```\n\nTo build the project from GIT repository, the additional 'make fetch' command should be issued\nto obtain all source code dependencies:\n\n```\n  make clean\n  make config\n  make fetch\n  make\n  make install\n```\n\nFor Windows, the `make install` command creates 'INSTALL' subdirectory and places the\nplugin content into desired subfolders.\n\nBy default, all supported formats of plugins for the target platform are built.\nThe list of modules for build can be adjusted by specifying FEATURES variable\nat the configuration stage:\n\n```\n  make config FEATURES='lv2 vst2 ui doc'\n```\n\nAvailable options are:\n  * clap - CLAP plugin binaries;\n  * doc - HTML documentation;\n  * gst - GStreamer plugin binaries;\n  * jack - JACK plugin binaries (not available under Windows);\n  * ladspa - LADSPA plugin binaries;\n  * launcher - Build launcher application for standalone JACK plugins;\n  * lv2 - LV2 plugin binaries;\n  * ui - build plugins with UI support;\n  * vst2 - VST2/LinuxVST plugin binaries;\n  * vst3 - VST2 plugin binaries;\n  * xdg - the X11 desktop integration icons (not necessary for Windows).\n\nBy default plugins use '/usr/local' path as a target directory for installation.\nTo override this path, the PREFIX variable can be overridden:\n\n```\n  make config PREFIX=/usr\n```\n\nTo build binaries for debugging, use the following commands:\n\n```\n  make config DEBUG=1\n```\n\nTo build binaries for testing (developers only), use the following commands:\n\n```\n  make config TEST=1\n```\n\nTo install plugins at the desired root directory, the DESTDIR variable can be specified:\n\n```\n  make install DESTDIR=\u003cinstallation-root\u003e\n```\n\nTo install only specific formats, use INSTALL_FEATURES option:\n\n```\n  make install FEATURES=lv2\n```\n\nTo build standalone source code package, the following commands can be issued:\n\n```\n  make config\n  make distsrc\n```\n\nAfter that, a standalone archive with source code will be created in the `.build` directory.\n\nWhen cross compiling, the AS, AR, CC, CXX, LD, etc. variables should be set in the environment according to the target/cross compile toolchain. The build host machine versions of those variables- HOST_AS, HOST_AR, HOST_CC, HOST_CXX, etc. have defaults set in the makefiles but may need to be overridden. To troubleshoot, run `make configure` with the VERBOSE option.\nAdditional variables should be configured:\n  * set the ARCHITECTURE option to the target architecture\n  * set the CROSS_COMPILE option to 1\n\nExample cross compile procedure for aarch64 target on x86_64 build host:\n```\n  make clean\n  make config ARCHITECTURE=\"aarch64\" CROSS_COMPILE=\"1\"\n  make fetch\n  make\n  make install\n```\n\nAfter successful completion, the cross compiled artifacts should be located in the directory specified by PREFIX.\n\nFor more build options, issue:\n\n```\n  make help\n```\n\nBuild example for macOS:\n```\n  brew install make pkgconf cairo freetype\n  gmake clean\n  gmake config FEATURES=\"lv2 ui\"\n  gmake fetch\n  gmake\n  sudo gmake install\n```\n\n\n# DEBUGGING\n\nFor debugging and getting crash stack trace with Ardour, please follow these steps:\n  * Open console\n  * Run ardour from console with --gdb option\n  * After gdb starts, issue 'run' command\n  * Do usual stuff to reproduce the problem\n  * After Ardour crashes, type 'thread apply all bt' in console and attach the output\n    to the bug report.\n\n# KNOWN PROBLEMS\n\n## unclutter\n\nPeople using the `unclutter` tool reported spontaneous freeze of the UI for LSP Plugins.\nThe `unclutter` tool is pretty rare and has not been updated over the years. So it does\nnot follow the latest changes made for X.Org. The problem can be solved by switching to\n`unclutter-xfixes` tool which works pretty OK with LSP UI.\n\n## gstreamer\n\nThere is no good support of MIDI interface in GStreamer now. Even if MIDI-based plugins are\navailable for GStreamer, there is no guarantee that they will fully work.\n\n## Wayland and XWayland\n\nLSP Plugins don't support Wayland protocol at this moment and are required to run under\nXWayland if Wayland is used as a system compositor. The implementation of XWayland is still\nimperfect and there are known cases where it can cause several problems with graphics.\n\nThere are several reasons why LSP Plugins don't support Wayland at this moment:\n  * It's a new protocol, and adding it's support requires some time;\n  * It provides some backward compatibility with X11, and the lack of Wayland support\n    is not so critical;\n  * Only few plugin formats and DAWs support Wayland at this moment. CLAP is the only known\n    plugin format that supports Wayland and the Presonus Studio for Linux is the only DAW\n    that requires Wayland as a must.\n\nIf you meet problems using LSP Plugins with Wayland, please consider switching back to X11.\n\n## 3D backend not working\n\nThis is the typical problem of interacting of the GUI with additional library that performs\n3D rendering. The reason can be:\n  * the library is missing in standard system libraries or nearby the plugin's binareis.\n  * the provided version of the library does not matched the required one by the UI.\n\nThe short way to diagnose that the library was not found or not accepted by the UI is just to\nvisit the `MENU` -\u003e `3D rendering` (visible only for plugins that use 3D rendering) and\nensure that there are no available items in the submenu.\n\nTo solve the problem, you need:\n  * ensure that the `liblsp-r3d-glx` library is present in `/usr/lib` or in\n    `/usr/local/lib` system paths OR:\n  * ensure that the `liblsp-r3d-glx` library is placed nearby the plugin's binaries\n    if you have some custom installation of the bundle (for example, in your `HOME` directory);\n  * ensure that the version of the `liblsp-r3d-glx` is matching to installed binaries;\n  * install the proper version of the library to the usual place if at least one of the checks\n    above were not fulfilled.\n\n# TESTING\n\nSince release 1.1.4 there is implemented testing subsystem that allows:\n  * perform manual tests (mtest module);\n  * perform automated unit testing (utest module);\n  * perform automated single-core performance testing (ptest module).\n\nManual tests are semi-automated or not automated at all. You may launch these tests\nto perform manual interaction with system or for retrieving some text data for further\nprocessing.\n\nUnit tests are completely automated and check that the produced result is correct for the\nspecific input data. By default unit tests are launched in separate processes and utilize\nall CPU cores for maximum performance. The status of each unit test is collected during\nexecution and list of all failed tests are printed after completion.\n\nPerformance tests measure performance of some function/module under different conditions,\ngather final statistics and output them in a table format. These tests are very useful for\nmeasuring single-core performance of different modules and functions and performing code\noptimizations.\n\nTo build testing subsystem, issue the following commands:\n```\n  make clean\n  make config TEST=1\n  make\n```\n\nAfter build, we can launch the test binary by issuing command:\n```\n  .build/host/lsp-plugin-fw/lsp-plugins-test\n```\n\nThis binary provides simple command-line interface, so here's the full usage:\n```\n  USAGE: {utest|ptest|mtest} [args...] [test name...]\n    First argument:\n      utest                 Unit testing subsystem\n      ptest                 Performance testing subsystem\n      mtest                 Manual testing subsystem\n    Additional arguments:\n      -a, --args [args...]  Pass arguments to test\n      -d, --debug           Disable time restrictions for unit tests\n                            for debugging purposes\n      -e, --execute         Launch tests specified after this switch\n      -f, --fork            Fork child processes (opposite to --nofork)\n      -h, --help            Display help\n      -i, --ignore          Ignore tests specified after this switch\n      -j, --jobs            Set number of job workers for unit tests\n      -l, --list            List all available tests\n      -mt, --mtrace         Enable mtrace log\n      -nf, --nofork         Do not fork child processes (for better\n                            debugging capabilities)\n      -nt, --nomtrace       Disable mtrace log\n      -o, --outfile file    Output performance test statistics to specified file\n      -s, --silent          Do not output additional information from tests\n      -t, --tracepath path  Override default trace path with specified value\n      -v, --verbose         Output additional information from tests\n```\n\nEach test has fully-qualified name separated by dot symbols, tests from different\ntest spaces (utest, ptest, mtest) may have similar fully-qualified names.\n\nTo obtain a list of all unit tests we can issue:\n```\n  .build/host/lsp-plugin-fw/lsp-plugins-test utest --list\n```\n\nAnd then we can launch all complex number processing unit tests and additionally\n'dsp.mix' unit test:\n```\n  .build/host/lsp-plugin-fw/lsp-plugins-test utest dsp.complex.* dsp.pcomplex.* dsp.mix\n```\n\nIf we don's specify any unit test name in argument, then all available unit tests\nwill be launched.\n\nTo start debugging of some unit test, you need to pass additional arguments:\n```\n  .build/host/lsp-plugin-fw/lsp-plugins-test/lsp-plugins-test utest --nofork --debug --verbose\n```\n\nBecause unit tests are short-time fully-automated tests, they are parallelized and\nexecuted by default by number_of_cores*2 processes. To disable this, we specify option\n--nofork. Also, unit test execution time is limited by 5 seconds by default, so when\ndebugging, our tests will be killed. That's why we specify --debug option to disable time\ncontrol. Option --verbose allows to output additional information by the unit test that is\nturned off by default.\n\nWe also can use performance tests to obtain full performance profile of target machine.\nBecause performance tests in most cases take much time for gathering statistics,\nthe final statistics for each test can be saved in a separate file by specifying --outfile\noption:\n```\n  .build/host/lsp-plugin-fw/lsp-plugins-test ptest -o performance-test.log\n```\n\nManual tests are mostly designed for developers' purposes.\n\n# SAST TOOLS\n\nThe Code of the project has been verified by the following SAST tools:\n\n* [PVS-Studio](https://pvs-studio.com/en/pvs-studio/?utm_source=website\u0026utm_medium=github\u0026utm_campaign=open_source) - static analyzer for C, C++, C#, and Java code.\n\n# TROUBLESHOOTING\n\nBecause there are many GNU/Linux distributions and software configurations,\nand, possible, internal bugs, plugins may have bad performance or even crash.\nThe good way to find the solutiong is to submit a bug or crash report. This\nsection describes the way to give detailed information to developers.\n\nTo submit a good bug or crash report, you should answer these questions:\n  * Did you use the previous version of plugins? If yes, did they properly work and\n    have you properly uninstalled the previous version?\n  * What version of plugins caused a crash? Was it LV2, LinuxVST, LADSPA or\n    standalone package?\n  * Did you try standalone version of plugins? Did they crash, too?\n  * What CPU and memory configuration do you use? This can be done by\n    issuing 'cat /proc/cpuinfo' and 'free' commands.\n  * What Linux distribution do you use? This may be done by issuing\n    'uname -a' and 'cat /etc/issue' commands.\n  * What version of required (see 'INSTALLATION') packages are present in your\n    system?\n  * Provide the full list (besides LSP Plugins) of plugins that you used in your host.\n  * If possible, provide the stack trace of the crash, given by GDB.\n    See 'PROFILING / DEBUGGING' section for details.\n  * If plugins have serious performance regression, please provide profiling file.\n    See 'PROFILING / DEBUGGING' section for details.\n  * If the plugin behaves incorrectly, there is also good reason to provide the dump\n    of internal state of the plugin which can be performed by selectecting the\n    'Dump for debug' menu item from the main menu. The internal state of the plugin\n    will be saved into the 'test-dumps' subdirectory of the system temporary directory.\n\n# CONTACTS\n\nThere is possible to submit feature requests and bugs on the\nGitHub.com page of the project:\n  https://github.com/sadko4u/lsp-plugins/issues\n\nSourceforge.net page of the project:\n  https://sourceforge.net/p/lsp-plugins/tickets/\n\nYou may contact us on the special feedback page:\n  https://lsp-plug.in/?page=feedback\n\nHope you have enjoyed our work!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flsp-plugins%2Flsp-plugins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flsp-plugins%2Flsp-plugins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flsp-plugins%2Flsp-plugins/lists"}