# On-Demand Loading

### From Audacity Manual

On-Demand Loading is an optional faster method of importing audio. Instead of a progress bar appearing while Audacity waits to import the entire file, the normal Audacity waveform starts to display almost immediately. You can play or edit wherever the normal waveform is displayed while the remaining waveform is still being drawn as a process running in the background.

On-Demand Loading is available as an option when importing most uncompressed files like WAV or AIFF. It is also available as an option when importing any file type with the FFmpeg library which is an optional download.

## Importing different file types using On-Demand Loading

### Uncompressed files

On-Demand Loading is used for most uncompressed files when choosing to read these files "directly from the original (faster)" instead of copying them in. The "read directly" option can be chosen when the warning appears for importing uncompressed audio files:

and also in the Import / Export Preferences:

The warning can be turned off in the Warnings Preferences, in which case the current import setting in Preferences will be used automatically.

On-Demand Loading of uncompressed files is much faster than copying in the audio, even if you wait for the waveform drawing to complete before playing or editing.

Uncompressed files shorter than 30 seconds long will always import using the normal progress bar even if you choose to "read directly". However on most machines the import will still seem to be immediate unless it is a slower machine or the processor is very busy with other tasks.

| If you choose "read directly" when importing WAV or AIFF files, do not rename, move or delete those files, otherwise your project will be missing audio. You can still copy in the audio to the project at any time at File > Check Dependencies... . See Audacity Projects for more details.

### All other file types

Any file type including compressed file types such as MP3 can be imported using On-Demand loading if you download and install the optional FFmpeg library then enable "Allow background on-demand loading" in the Libraries Preferences:

Once you have installed FFmpeg and enabled FFmpeg On-Demand in Preferences as above, the following file types should import using FFmpeg On-Demand, without changing any other settings, and irrespective of the import method: AAC, AC3, AMR(NB), M4A, MOV, MP4, WMA and audio from video files.

To force import of a file using FFmpeg, choose File > Import > Audio... or File > Open... then choose FFmpeg-compatible files in the "Files of type" drop-down in the File Export Dialog. To force import using FFmpeg when dragging files in, set a rule for that file format to use FFmpeg in Extended Import Preferences.

Unlike using On-Demand loading for uncompressed files, On-Demand loading using FFmpeg always copies the audio in rather than reading it directly. Therefore for most file types, FFmpeg On-Demand will be somewhat quicker than using FFmpeg without On-Demand, but will show less speed improvement than "read directly" On-Demand does for WAV and AIFF files.

For WAV and AIFF files, the quickest import method will always be "read directly" On-Demand.

## Using On-Demand Loading

When you import an On-Demand file by any means ( File > Open..., File > Import > Audio... or dragging in), a sequence of patterned blocks appears almost immediately, representing the uncomputed waveform. The blocks are then progressively replaced from left to right by the normal Audacity waveform as soon as it has been computed. You can play or edit the track at once wherever that normal waveform is displaying, without waiting for the remainder of the waveform to be drawn.

## Extra On-Demand features using read-directly WAV and AIFF import

When importing WAV and AIFF using read-directly On-Demand, you can also change the focal point from which the waveform is computed. To do this, either click in the track at the leftmost point from which you want the waveform drawn, or drag a selection in either direction. In the image below, we clicked to place the cursor in the waveform at a time of 23 minutes. The waveform then started being drawn rightwards from the cursor point:

Using read-directly On-Demand, you can now edit or play from the new focal point. You can also start playback from a new position without changing the focal point of the waveform by clicking or dragging a region in the Timeline.

Once the computation point has reached the end of the track, any uncomputed waveform will be drawn from right to left, unless interrupted by clicking elsewhere at an uncomputed point.

Multiple files may be imported simultaneously, and the waveform computation point moved from one to track to the other by clicking in the required track.

The percentage of the waveform that has been computed is displayed on the Status Bar, as shown at bottom left of the image above. When multiple files are being imported, the Status Bar will display the overall percentage of the multiple tracks that has been computed. To make the Status Bar display the percentage completion of a particular track, move the mouse over that track.

### Slow seeking when moving the focal position

If the drive the file is being imported from is not able to seek rapidly through the file, the On-Demand imported track may be slow to respond when moving the focal position. This will be especially noticeable before the waveform has been fully computed. Slow seeking could occur on Mac computers when importing CD tracks from the Finder, or when using older external USB drives.

##### Views

##### Help Location

- Local manual in use
- Internet manual