README

ℹ️ If you've been using Inline Audio (aka Audio URL to Player), that extension has been abandoned. This is a fresh, actively maintained replacement built for Flarum 2.0+ (and 1.8 via the 1.x branch).

Inline Audio Player

A Flarum extension that automatically converts audio file links in posts into inline players, with an optional [player] BBCode tag.

Audio links are replaced with a compact, clickable filename. The standard HTML5 player stays hidden until the user clicks the title — keeping posts clean and readable. When expanded, a pulsating icon indicates playback status at a glance.

Features

Auto-detects links to audio files and replaces them with an inline player — no BBCode required
Players are initially collapsed: only the filename is shown; clicking it reveals the standard HTML5 player
A circle-play icon precedes the filename; it switches to a pulsating circle-pause icon while audio is playing — regardless of whether the player is expanded or collapsed
When a player starts, any other playing audio on the page is paused automatically
[player]URL[/player] BBCode for explicit embedding — same collapsible UI as auto-detected links
The HTML5 player follows the Flarum theme (light/dark) rather than the OS theme
Accessible: keyboard navigation, screen reader labels, respects prefers-reduced-motion
Works seamlessly with FoF Upload when using a filename-link upload template (see below)

Supported formats: mp3 · wav · ogg · flac · m4a · aac · webm · mp4 · mpeg · mpg · wave

Installation

composer require ekumanov/flarum-ext-inline-audio

Update

composer update ekumanov/flarum-ext-inline-audio
php flarum cache:clear

Uninstall

composer remove ekumanov/flarum-ext-inline-audio

BBCode

[player]https://example.com/audio/track.mp3[/player]

FoF Upload Integration

If you use FoF Upload and want audio files to automatically render as inline players after uploading — without requiring users to manually wrap links in [player] tags — you can register a filename-link upload template in your forum's extend.php.

FoF Upload does not ship with this template; add it yourself as follows:

use FoF\Upload\Contracts\Template;
use FoF\Upload\File;
use Flarum\Foundation\AbstractServiceProvider;
use FoF\Upload\Helpers\Util;

class FilenameLink implements Template
{
    public function tag(): string   { return 'filenamelink'; }
    public function name(): string  { return 'Filename link'; }
    public function description(): string { return 'Generates a link with the filename as text'; }

    public function preview(File $file): string
    {
        return '[' . $file->base_name . '](' . $file->url . ')';
    }
}

class FilenameLinkServiceProvider extends AbstractServiceProvider
{
    public function register()
    {
        $this->container->make(Util::class)
            ->addRenderTemplate($this->container->make(FilenameLink::class));
    }
}

// In your return array:
(new Extend\ServiceProvider())->register(FilenameLinkServiceProvider::class),

Once registered, select Filename link as the upload template in the FoF Upload admin settings.

To restrict the template to audio files only, set a MIME type filter in FoF Upload using this regex:

^audio\/(flac|x-flac|mp3|x-mp3|mpg|mpeg|mpeg3|x-mpeg|x-mpeg3|x-mpg|x-mp4a|x-mpegaudio|mp4|vnd.wave|wav|wave|x-wav|x-pn-wav|ogg|x-ogg|x-ogg-flac)

Compatibility

Branch	Flarum version
`main` (this)	Flarum 2.0+
`1.x`	Flarum 1.8

ekumanov / flarum-ext-inline-audio

Maintainers

Package info

Statistics

Security