A lightweight, dependency-free audio player for DhivehiGPT-generated "read aloud" audio. Turns a plain <audio> tag into a branded control bar, embeddable on any website — no build step required. Built for modern evergreen browsers (Safari 10.1+/Chrome 58+/Firefox 52+/Edge 15+ — see requirements).
Full documentation: docs.javaabu.com/docs/dhivehigpt-player-js
Find yourself stuck using the package? Found a bug? Feel free to create an issue on GitHub, we'll try to address it as soon as possible.
If you've found a bug regarding security please mail info@javaabu.com instead of using the issue tracker.
npm install @javaabu/dhivehigpt-player --saveOr, with no build step at all, via jsDelivr:
<script src="https://cdn.jsdelivr.net/npm/@javaabu/dhivehigpt-player/dist/dhivehigpt-player.umd.min.js"></script>Or download it and self-host: the same file is committed at dist/dhivehigpt-player.umd.min.js in this repo.
Add data-dhivehigpt-player to a standard <audio> tag — it's converted automatically:
<audio data-dhivehigpt-player src="https://example.com/article.mp3"></audio>Options are set via data-* attributes, e.g. data-dark="true", data-accent="true", data-sticky="true". See the data-attributes reference for the full list.
Or initialize programmatically:
import { AudioPlayer } from '@javaabu/dhivehigpt-player';
const player = new AudioPlayer('#my-audio', { accent: true, sticky: true });
player.on('play', () => console.log('playing'));React, Vue, Svelte, and jQuery integrations are available at @javaabu/dhivehigpt-player/react, /vue, /svelte, and /jquery (each a separate entry, so the core bundle only ships what you actually use). Angular, Alpine.js, and Laravel Livewire are supported too — see the framework guides for details.
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
If you discover any security related issues, please email info@javaabu.com instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.