pluginval – Cross platform plugin testing and validation tool

플러그인 테스트 및 검증

pluginval은 VST, AU, VST3 플러그인을 로드하여 일련의 검증 테스트를 실행합니다. 각 테스트는 플러그인의 호출 안정성, 매개변수 동작, 상태 복원 등을 검사하며, 오류가 발생하면 콘솔에 상세 로그를 출력합니다.

GUI 및 헤드리스 모드 지원

사용자는 그래픽 인터페이스를 통해 플러그인을 드래그하거나 스캔하여 테스트할 수 있습니다. 또한 명령줄에서 헤드리스 모드로 실행하여 지속적 통합(CI) 시스템에 통합할 수 있으며, 테스트 결과에 따라 종료 코드를 반환합니다.

GUI 모드 사용법

빌드가 완료되면 bin 디렉터리에서 실행 파일을 찾아 실행합니다. 프로그램이 시작되면 빈 플러그인 목록이 표시되며, “Options” 버튼을 클릭하여 플러그인이 있는 디렉터리를 추가하거나, 플러그인 파일을 직접 목록으로 드래그하여 추가할 수 있습니다. 목록에서 플러그인을 선택하고 “Test Selected” 버튼을 누르면 테스트가 시작되며, 결과는 “Console” 탭에 표시됩니다.

헤드리스 모드 사용법

명령줄에서 다음과 같이 실행하여 헤드리스 모드로 테스트를 수행할 수 있습니다:
./pluginval --strictnessLevel 5 --validate <path_to_plugin>
이 명령은 strictness 레벨 5까지의 모든 테스트를 실행하며, 모든 테스트가 통과하면 종료 코드 0을, 하나라도 실패하면 종료 코드 1을 반환합니다. strictnessLevel은 1에서 10 사이로 설정할 수 있으며, 숫자가 높을수록 더 철저한 테스트가 수행됩니다. 모든 옵션을 보려면 ./pluginval -h 명령을 사용할 수 있습니다.

이런 경우에 유용합니다

플러그인 개발자는 자신의 플러그인이 다양한 호스트 환경에서 안정적으로 작동하는지 검증하기 위해 pluginval을 사용할 수 있습니다. 호스트 소프트웨어 개발자는 지원하려는 플러그인의 호환성을 사전에 테스트하여 사용자 경험을 개선할 수 있습니다. 또한 플러그인 사용자는 문제가 발생했을 때 pluginval을 통해 상세한 진단 로그를 생성하여 개발자에게 전달함으로써 문제 해결 속도를 높일 수 있습니다.

지원 환경·시스템 요구사항

pluginval은 Windows, macOS, Linux에서 실행 가능한 크로스 플랫폼 애플리케이션입니다. Windows에서는 공식 빌드 스크립트를 통해 컴파일할 수 있으며, VST2 플러그인을 테스트하려면 별도로 VST2 SDK를 설치하고 환경 변수를 설정해야 합니다.

최신 버전·업데이트

현재 버전은 1.0.4이며, 최신 소스 코드와 릴리스 정보는 GitHub 저장소에서 확인할 수 있습니다. 업데이트는 저장소의 릴리스 페이지에서 제공되는 사전 컴파일된 바이너리를 다운로드하거나, 최신 소스를 클론하여 다시 빌드함으로써 적용할 수 있습니다.

제한 사항·확인 사항

VST2 플러그인 테스트를 위해서는 VST2 SDK가 시스템에 설치되어 있어야 하며, 빌드 과정에서 VST2_SDK_DIR 환경 변수를 설정하거나 프로주서 설정에 경로를 추가해야 합니다. 이는 VST2 SDK가 JUCE 프레임워크에 더 이상 포함되지 않기 때문입니다.