Practical overview
When it fits
Use SoundNet when a research workflow needs pretrained audio representations, category predictions, or a starting point for adapting a sound model. Its documented scripts operate on audio file lists; the training method uses the natural synchronization of audio and video to transfer visual-model supervision.
Who it is for
- Audio researchers who want pretrained representations for downstream classification experiments.
- Machine-learning practitioners studying sound recognition or student-teacher transfer from visual models to audio.
- Researchers adapting the provided code to labeled audio datasets.
Documented uses
- Produce object and scene category scores for audio files.
- Extract time-varying SoundNet features for downstream machine-learning tasks.
- Fine-tune a pretrained model using audio files paired with integer category labels.
- Train the five- or eight-layer model using audio and visual-model class probabilities.
Requirements & limits
The code is in a public repository marked with an MIT license. The README lists downloadable five- and eight-layer pretrained models.
- The implementation uses Torch7 and Lua rather than a hosted analysis interface.
- Feature extraction requires Torch7 HDF5 in addition to Torch7 audio and SoX.
- The README recommends the eight-layer pretrained model.
- The supplied fine-tuning script may require changes for a particular dataset.
- Training from scratch depends on audio plus class probabilities from visual models; the README describes the corresponding two-million-video data release as planned.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Extract sound features from an audio list
Generate SoundNet feature files for audio inputs using the provided extraction script.
Before you start
- Torch7, Torch7 audio, and SoX.
- Torch7 HDF5 for feature extraction.
- An audio file for each entry in a text list; the README uses MP3 and says most audio formats should be supported.
- A pretrained SoundNet model.
Steps
Create a text file with one audio file per line.
Run
list=data.txt th extract_feat.lua.To select another layer, set a layer value, as in
list=data.txt layer=24 th extract_feat.lua.Use the resulting time-by-dimension features; average-pool or max-pool over time if a fixed-length vector is needed.
Expected outcome
Feature data is written to HDF5 files alongside the input files. The default extraction layer is conv7.
Guide limitations
- The README says a GPU is probably needed.
- The documented feature output varies over time; fixed-length vectors require pooling.
- The README does not provide a general compatibility guarantee for audio formats.
Generate object and scene category predictions
Use the provided script to produce SoundNet category scores for a list of audio files.
Before you start
- Torch7, Torch7 audio, and SoX.
- A text file with one audio file per line.
- A pretrained SoundNet model.
Steps
Create a text file such as
data.txt, listing the audio files to process.Run
list=data.txt th extract_predictions.lua.Use
categories/categories_places2.txtfor scene labels andcategories/categories_imagenet.txtfor object labels.
Expected outcome
The script writes HDF5 files containing category scores alongside the input files and outputs the top-scoring object and scene category.
Guide limitations
- The README says MP3 is used and most audio formats should be supported, but does not guarantee support for every format.
- The documented requirements say a GPU is probably needed.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- cvondrick/soundnet · Official homepage title · retained in its source language

