Skip to content

Custom Audio

Introduced in v1.7, the Custom Audio source allows you to listen to any text you select or type, provided you have the URL of the audio file. This feature opens up a world of pronunciation resources that might not be available through Definer's standard audio sources.

Usage

Using Custom Audio is pretty straightforward:

  1. Configure the audio URL (see Configuration section below)
  2. Select or type a word/phrase
  3. A playable audio button appears in your results

custom-audio.avif

If Definer can't find an audio file at your specified URL, you'll see a disabled, grayed-out button – your visual cue that no audio is available for that selection:

not-found.avif

Configuration

To set up or modify your Custom Audio settings, go to:
OptionsSourcesCustom AudioSettings.

settings.avif

URL

This is where the magic happens! Enter the URL of the audio file you want to use. What makes this feature particularly powerful is its support for the Liquid Template Language, which lets you create dynamic URLs that change based on your selected text.

Think of it as creating a formula rather than a fixed address. When you search for a word, Definer will plug that word into your URL formula to find the right audio file.

Let's see some examples...

Oxford Pronunciations via Google

Google hosts Oxford pronunciation recordings on their ssl.gstatic.com domain.

Try the following URL for that classic British pronunciation:

liquid
https://ssl.gstatic.com/dictionary/static/sounds/oxford/{{str}}--_gb_1.mp3

For American pronunciation:

liquid
https://ssl.gstatic.com/dictionary/static/sounds/oxford/{{str}}--_us_1.mp3

The {{str}} placeholder automatically gets replaced with your selected text. Look up "extraordinary", and Definer searches for "extraordinary--_us_1.mp3" at the specified location.

Youdao

For clear English pronunciations from Youdao's extensive library:

liquid
https://dict.youdao.com/dictvoice?audio={{str}}&type=1

Autoplay

When enabled, audio will start playing immediately after your search completes - no need to click the play button. This option is disabled by default.