Sound Clips

=== Feature Design Document ===
(none)
=== Functional Spec ===
* 30(.000) seconds maximum. (STC)
* format, 16-bit signedNote that if your audio editing software has the option to choose signed vs. unsigned 16 bits, select signed., 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:
On Unix and Unix-like operating systems (including macOS), the command will produce something like:
If you have the package installed (see below; versions exist for all operating systems), you should also have the application, which you can invoke with , and this will show additional information from the audio file:
* The codec to be used is PCM signed 16-bit little-endian (which calls ; 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 by mixing the channels equally, but this might produce unexpected results in the audio. 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:
 Account Level
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 ===
{ class="sortable" width="100%" 
- 
! Windows
! Mac
! Linux
-
; Audio for SL
: A purpose-built program for converting audio files for use in Second Life. Provides format and sample rate conversion, automatic splitting for files longer than the max allowable for upload, and volume normalization.
; Audacity
: Audacity is a free and open-source digital audio editor and recording application software. Torley Linden did a video tutorial on creating and uploading sounds via Audacity, viewable at http://www.youtube.com/watch?v=QBVmFafFatE
: Note: in some scenarios, the resulting audio file, after uploading, will have a much lower volume than average (even using scripts setting the volume to maximum). I have not been able to track the source of this discrepancy, but it's easily fixed — just boost the volume on Audacity just below the threshold where you start getting unacceptable distortion, and then upload it to SL.
; Ardour
: Ardour is a free hard disk recorder and digital audio workstation application. It may be more suitable for users familiar with audio editing & s in general.
; ffmpeg
: ffmpeg is a command-line tool, designed for processing of video and audio files. Recommended for advanced users only! See below example.
; r8brain
: r8brain is a basic, free audio transcoder.
; Audacity
: Audacity is a free and open-source digital audio editor and recording application software. Torley Linden did a video tutorial on creating and uploading sounds via Audacity, viewable at http://www.youtube.com/watch?v=QBVmFafFatE
; Ardour
: Ardour is a free hard disk recorder and digital audio workstation application. It may be more suitable for users familiar with audio editing & DAWs in general.
; ffmpeg
: ffmpeg is a command-line tool, designed for processing of video and audio files. Recommended for advanced users only! See below example.
; GarageBand
: GarageBand is a line of digital audio workstations for macOS, iPadOS, and iOS devices.
; Audacity
: Audacity is a free and open-source digital audio editor and recording application software. Torley Linden did a video tutorial on creating and uploading sounds via Audacity, viewable at http://www.youtube.com/watch?v=QBVmFafFatE
; Ardour
: Ardour is a free hard disk recorder and digital audio workstation application. It may be more suitable for users familiar with audio editing & DAWs in general.
; ffmpeg
: ffmpeg is a command-line tool, designed for processing of video and audio files. Recommended for advanced users only! See below example.
}
==== ffmpeg ====
The following section assumes some familiarity with a Linux-based operating system and 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 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 to convert a sound file to a Second Life compatible 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 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 format will save the output stream in sequential 3-digit segments. example: , , .
Once created, the resulting files should be ready to upload into Second Life.
===== Batch conversion =====
The following batch command can be used to convert an entire directory of files into segmented 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 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 ===
Audio Test
=== 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 ===