Audio::Silan

Detect audio cue-in, cue-out using silan https://github.com/x42/silan

Audio::Silan

Audio silence detection using silan (https://github.com/x42/silan)

image https://github.com/jonathanstowe/Audio-Silan/workflows/CI/badge.svg not found

Synopsis


use Audio::Silan;

my $silan = Audio::Silan.new;

my $promise = $silan.find-boundaries($some-audio-file);

await $promise.then(-> $i { say "Start : { $i.start } End: { $i.end }" });

Description

This module provides a mechanism to use Silan to detect the silence at the beginning and end of an audio file (which are sometimes described as cue in and cue out points.)

It allows the setting of the silence threshold and "hold off" (that is the minimum length of silence required before it is considered the end of the audio.) For certain material these values may need adjustment in order to provide accurate output.

Because the detection may take some time for larger files, this takes place asynchronously: the method find-boundaries returns a Promise which will be kept with the result of the detection (or broken if the detection failed.)

Installation

In order for this to work you will need a working installtion of Silan, this is often available as a package on Unix-like systems and you can use the appropriate package manager to install it. If it is not available as a package then it should be possible to install it from source.

Assuming you have a working Rakudo installation you should be able to install this with zef :

# From the source directory

zef install .

# Remote installation

zef install Audio::Silan

Other install mechanisms may be become available in the future.

Support

Suggestions/patches are welcomed via github at:

https://github.com/jonathanstowe/Audio-Silan/issues

It should be borne in mind before reporting an issue that this depends on the behaviour of silan itself and that is likely that any mis-reporting of the audio bounds is a result of silan itself or the parameters that are being used, I do know that version 0.3.2 of silan (which is frequently distributed with OS distributions,) may mis-detect for longer MP3 files (for example a 2 hour MP3 file may be detected as "ending" around the hour mark,) if this causes a problem to you then you should try upgrading the silan. This issue may also suggest that for certain types of file, the underlying libraries may also have an impact.

Licence

This is free software.

Please see the LICENCE file in the distribution

Ā© Jonathan Stowe 2015 - 2021

Audio::Silan v0.0.9

Detect audio cue-in, cue-out using silan https://github.com/x42/silan

Authors

  • Jonathan Stowe

License

Artistic-2.0

Dependencies

File::WhichJSON::Fast

Test Dependencies

Provides

  • Audio::Silan

Documentation

The Camelia image is copyright 2009 by Larry Wall. "Raku" is trademark of the Yet Another Society. All rights reserved.