SecretLabNAudio

An advanced audio player API for SCP: Secret Laboratory using NAudio

This library has a number of open-source dependencies. See Attributions

Features

Watch the demo

• Fully customizable audio provider interfaces
• Real-time audio processing
• Streaming files from disk
• Resampling and downmixing
• Ogg Vorbis support using NVorbis
• MP3 support using NLayer
• Speaker personalization
• SpeakerToy pooling
• Automatic reader resolution by file type
• Cache for short audio clips
• Windows-only Media Foundation support for a wider range of formats, and decoding over the network

Installation

Single-File

1. Download the SecretLabNAudio.zip file from the releases page
2. Extract bin/SecretLabNAudio.dll from the archive into the global plugins directory
   • Linux: ~/.config/SCP Secret Laboratory/LabAPI/plugins/global/
   • Windows: %appdata%/SCP Secret Laboratory/LabAPI/plugins/global/
3. Restart the server

Modular

1. Download the SecretLabNAudio.Core.dll file from the releases page
2. Download the SecretLabNAudio.zip file from the releases page
3. Extract the necessary DLLs from the bin/ directory
   • See the table below for what you need
   • Place dependencies into the dependencies directory
     • Linux: ~/.config/SCP Secret Laboratory/LabAPI/dependencies/<port>/
     • Windows: %appdata%/SCP Secret Laboratory/LabAPI/dependencies/<port>/
   • Place plugins into the plugins directory
     • Linux: ~/.config/SCP Secret Laboratory/LabAPI/plugins/<port>/
     • Windows: %appdata%/SCP Secret Laboratory/LabAPI/plugins/<port>/
4. Restart the server

Modules

To support reading from some file formats, install the modules you need.

Development

Simply install the SecretLabNAudio.Core package from NuGet.

Manual installation:

1. Reference the SecretLabNAudio.Core.dll file from the releases page
2. Install the NAudio.Core package from NuGet