Data Attributes | dhivehigpt-player-js

The easiest way to use the player is to add data-dhivehigpt-player to a standard <audio> element. All configuration is read from data-* attributes on that same element.

<audio
  data-dhivehigpt-player
  src="https://example.com/article.mp3"
  data-accent="true"
  data-sticky="true"
></audio>

This works both with the npm package (call init(), or let the UMD build auto-init) and the jsDelivr CDN build.

Reference

Attribute	Values	Default	Description
`data-dhivehigpt-player`	(presence only)	—	Marks the element for auto-conversion. Required.
`data-src`	URL	—	Overrides the audio source. If omitted, the element's own `src`/`<source>` is used.
`data-dark`	`auto` \| `true` \| `false`	`auto`	`auto` follows the visitor's OS/browser dark mode preference live.
`data-accent`	`true` \| `false`	`false`	Solid brand-color (`#39bbb0`) skin. Takes priority over `data-dark`.
`data-shadow`	`none` \| `hairline` \| `soft` \| `lift`	`hairline`	Controls the bar's box-shadow / elevation.
`data-flush`	`true` \| `false`	`false`	Edge-to-edge styling: no border-radius, no border.
`data-show-time`	`true` \| `false`	`true`	Show/hide the elapsed / total time label.
`data-show-speed`	`true` \| `false`	`true`	Show/hide the playback-speed control.
`data-show-volume`	`true` \| `false`	`true`	Show/hide the volume control.
`data-speeds`	comma-separated numbers	`1,1.25,1.5,2,0.75`	The list of rates the speed button cycles through, in order.
`data-sticky`	`true` \| `false`	`false`	Stick the bar to the bottom of the viewport while playing. See Sticky player.
`data-load-font`	`true` \| `false`	`false`	Opt-in to loading the "Outfit" font from Google Fonts. See Styling & Theming.

A boolean attribute is also considered true when present with an empty value, e.g. data-accent alone is the same as data-accent="true".

The "Powered by DhivehiGPT" branding link is always shown and cannot be disabled via attributes.