API

abstract type AbstractAudioSource end

Abstract class for all audio sources. Possible sources are:

• CmdAudioSource
• FileAudioSource
• RawAudioSource
• URLAudioSource

Lib:

• Recorder

CmdAudioSource(c::String)

Audio from a command provided as string.

FileAudioSource(path::AbstractString)

Audio from a file.

RawAudioSource(x::AbstractArray, fs)

Audio from an Array.

URLAudioSource(url::AbstractString)

Audio from an URL.

load(s::AbstractAudioSource, subrange::Union{AbstractRange, Colon} = :, ch=1)

Get the audio data and sampling rate for desired subrange and channel. Return (data, fs)

resample(s::FileAudioSource, fs::Int64; out=nothing)

Resample a file source.

Base.show(io::IO, ::MIME"text/html", s::AbstractAudioSource)

In HTML context, show an AbstractAudioSource as audio tag.

Lib to extend AudioSources with an audio recorder. Can be imported with using AudioSources.RecorderLib Recommanded to use in a notebook, see the example notebook

mutable struct Recorder

Object to store recording parameters and recorded data.

Fields

• fs::Int sampling rate, in Hz
• chunkduration::Float64 record by chunks of chunkduration length
• chunksize::Int ≈ chunkduration*fs
• channel::Channel used for async communication
• data::AbstractArray store the recorded audio
• datatype::DataType type of the data array elements

Recorder(; <keyword arguments>)

Initialize Recorder with default values if not specified.

Arguments

• fs::Int = 16000 sampling rate, in Hz
• chunkduration::Float64 = 0.5 record by chunks of chunkduration length
• datatype::DataType = Float32 data type to store the data, Floats are recommanded

start(r::Recorder, erase=true)

Start recording. Recommended to run it asynchronously (@async start(rec)). Set erase to true to reset the previously recorded data, otherwise the new recording is appended to the previous one.

stop(r::Recorder)

Stop recording.

recordfor(r::Recorder, time, erase=true)

Start a recording for given time (in seconds)

isrecording(r::Recorder)

Indicate whether or not the Recorder is currently active.

getduration(r::Recorder)

Give the length of the recording (in seconds).

struct RecorderWidget

UI component for Recorder.

RecorderWidget()

Initialize a RecorderWidget. It will be displayed as an HTML button.