SoundFiles Player

SoundFiles Player is the official WordPress integration for SoundFiles.eu.

The plugin lets you embed public SoundFiles audio using a shortcode or a supported SoundFiles URL. The player is isolated from theme CSS with Shadow DOM, so its layout and controls remain consistent across WordPress themes.

Features include:

• Responsive audio player with waveform.
• Theme-safe styling using Shadow DOM.
• Live preview in the WordPress settings screen.
• Custom PLAY, waveform, background, border, and text colors.
• Adjustable player width.
• Shortcodes for simple and advanced embeds.
• Translation-ready interface that follows the WordPress locale.
• No third-party icon or font CDN dependency.

Shortcodes

Basic player:

[soundfiles id="FILE_HASH"]

Use one color for PLAY and WAVE:

[soundfiles id="FILE_HASH" color="#105b81"]

Set PLAY and WAVE colors independently:

[soundfiles id="FILE_HASH" play="#105b81" wave="#3a6b84"]

Embed from a SoundFiles URL:

[soundfiles_player url="https://soundfiles.eu/FILE_HASH/file"]<h3>External services</h3>

This plugin connects to SoundFiles.eu in order to play the audio file selected by the site owner. When a player is displayed, the visitor’s browser requests the audio stream from soundfiles.eu and the waveform image from storage.soundfiles.eu.

SoundFiles.eu service: https://soundfiles.eu/
Developer information: https://soundfiles.eu/developers

No SoundFiles account or API key is required by this WordPress plugin for public audio embeds.

Development

All JavaScript and CSS files distributed with this plugin are the original, human-readable source files. The plugin does not use npm, webpack, minification, transpilation, or any other build step, and it does not include generated bundles that require separate source files.

The player stylesheet is stored in assets/player.css and is loaded inside the player’s Shadow DOM by assets/embed_sf.js. The WordPress settings screen uses the separate source files assets/admin.css and assets/admin.js.