Sound Clips
Feature Design Document
(none)
Functional Spec
- 30(.000) seconds maximum. (STC)
- PCM WAV format, 16-bit signed[1], 44.1 kHz, mono/stereo (downmixed to mono by the viewer at upload time)
Second Life supports in-world sound clips, which can be played to all residents within range. The maximum time any clip can be is 30 seconds, requiring longer sounds to be stitched together. There are various LSL functions that can be used to play sound clips, as well as a built-in system for gestures. Uploading a sound clip has a variable cost (see below), and the clip must be compatible with SL. As the Knowledge Base says:
Sound files must be:
- WAV files in standard PCM format.
- 16-bit with 44.1 kHz sample rate.
- Mono format. Stereo format will be automatically converted to mono.
- 30 seconds or less in length. Or more precisely: 1,323,000 samples or less in length.
On Unix and Unix-like operating systems (including macOS), the command file audiofilename.wav will produce something like:
RIFF (little-endian) data, WAVE audio, Microsoft PCM, 16 bit, mono 44100 Hz
If you have the ffmpeg package installed (see below; versions exist for all operating systems), you should also have the ffprobe application, which you can invoke with ffprobe -show_streams -pretty audiofilename.wav, and this will show additional information from the audio file:
- The codec to be used is PCM signed 16-bit little-endian (which ffmpeg calls pcm_s16le; it's the most common codec and generally used by default when writing WAV files).
- Sample rate: 44.100000 KHz
- 1 channel (it's mono, after all) and 16 bits per sample.
Also note that if you upload a stereo (or multi-channel) audio file, it will be converted to mono, but this might produce unexpected results in the audio (it's not quite clear what exactly the SL Viewer does, or if it's handled server-side). To give you a much higher degree of control over how exactly the channels are mixed together — there are many different ways of doing so, some of which might not have existed yet when LL wrote the audio uploading code — you should best leave that to your audio software; in other words, you'll get better results by using the below-mentioned software to mix the channels into just one, than simply relying on SL's viewers and servers to do it (hint: it's the same as with textures; you get far sharper images if you resize them yourself to powers-of-two width and height before uploading).
Why mono? I want stereo!
Second Life's in-world audio system is actually "more than stereo" — it's 3D, full-surround, immersive, so-called spatial sound, vaguely similar to how Dolby Atmos or Ambisonics works (but probably not so sophisticated!).
That means that sounds can come from anywhere, from any distance, and they will play appropriately on each channel of your speakers or headphones to give you clues about the origin of the sound and how far away it is. These sounds are necessarily "mono" (one channel) in nature and then mixed together with all other sounds in a scene to produce the final stereo sound that gets delivered to your speakers/headphones.
If you wish to play stereo music inside SL, your best choice is via a streaming server.
Pricing Model
The cost of uploading a sound clip is as follows:
| Basic | Premium | Premium Plus |
|---|---|---|
| 10 L$ | 10 L$ | 0 L$ |
Note that the price is fixed; it doesn't depend on sample size, length, or quality. If you make a mistake, however, you need to upload a new sample and will be charged again (just like with uploading other assets), even if the filename is the same.
Audio software
| Windows | Mac | Linux |
|---|---|---|
|
|
|
ffmpeg
The following section assumes some familiarity with a Linux-based operating system and bash scripting. One of the best tools for audio conversion under Linux is the tool ffmpeg. It is a command line tool that can convert both video and audio from one supported format to other supported formats. Source code for ffmpeg can be downloaded from the link but most modern Linux distributions come with a modern version already installed or ready for download in their package management system. Consult your distribution's documents on how to install packages and what package management system is supported.
The following command will use ffmpeg to convert a sound file to a Second Life compatible WAV file while cutting it just under 30 second segments for instant upload.
ffmpeg -i <filename> -f segment -segment_time 29.9 -ac 1 -ar 44100 <output filename>.%03d.wav
Command line explanation as follows.
- -i <filename> The input file to convert.
- -f segment -segment_time 29.9 Save the output file in 29.9 second segments. You can specify any time duration in the segment_time option, including 30 for 30 seconds. But experimenting using 30 as a segment size sometimes produces file sizes too large for uploading. The 29.9 entry seems to be the perfect size for uploading without issues.
- -ac 1 Converts a multi-channel, stereo, stream into a single, mono, output stream.
- -ar 44100 Makes sure the output frequency is 44100 Hz.
- <output filename>.%03d.wav Specifies the output name and format for the numbering of each segment. The %03d format will save the output stream in sequential 3-digit segments. example: mozart.000.wav, mozart.001.wav, mozart.002.wav.
Once created, the resulting WAV files should be ready to upload into Second Life.
Batch conversion
The following batch command can be used to convert an entire directory of mp3 files into segmented WAV files for direct upload.
$ for i in *.mp3; do ffmpeg -i ${i} -f segment -segment_time 29.9 -ac 1 -ar 44100 ${i/mp3/}%03d.wav ; done
Windows
The following command, similar to the prior Linux section, will convert a file to the correct WAV format using ffmpeg on Windows.
ffmpeg -i <input> -c:a pcm_s16le -ac 1 -ar 44100 <output>.wav
Online tools
An online converter which provides complete control over the conversion process can be viewed at Online-Convert.
Test scripts
Relationship to other features
List of features that need to be tested when this feature changes, and why.
Upload Assets - Upload a sound clip and make sure it still works.
User Guides
(none)
Notes
- ↑ Note that if your audio editing software has the option to choose signed vs. unsigned 16 bits, select signed.