PHPackages                             ianhobbs/song-block - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. ianhobbs/song-block

ActiveKirby-plugin[Image & Media](/categories/media)

ianhobbs/song-block
===================

An extended audio block for Kirby with poster image, title, subtitle and description

1.0.2(2d ago)01MITVueCI failing

Since Aug 16Pushed 2d agoCompare

[ Source](https://github.com/ianhobbs/kirby-song-block)[ Packagist](https://packagist.org/packages/ianhobbs/song-block)[ Docs](https://github.com/ian-hobbs/song-block)[ RSS](/packages/ianhobbs-song-block/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

Song Block for Kirby CMS
========================

[](#song-block-for-kirby-cms)

An extended audio block for [Kirby](https://getkirby.com): an audio player with a poster image, title, subtitle and rich-text description — with a live preview in the Panel.

Features
--------

[](#features)

- 🎵 Audio file picker/upload (mp3, m4a, ogg, wav)
- 🖼 Square poster image with automatic cropping
- ✏️ Inline-editable title, subtitle and description directly in the Panel preview
- ⚙️ Settings for player controls and autoplay
- 🧩 Frontend snippet included — override it in your site to customize markup

Requirements
------------

[](#requirements)

- Kirby 4 or Kirby 5

Installation
------------

[](#installation)

### Composer

[](#composer)

```
composer require ianhobbs/song-block
```

### Git submodule

[](#git-submodule)

```
git submodule add https://github.com/ian-hobbs/song-block.git site/plugins/song-block
```

### Manual

[](#manual)

Download and copy this repository to `/site/plugins/song-block`.

Usage
-----

[](#usage)

Add the block to a `blocks` field in your blueprint:

```
fields:
  text:
    type: blocks
    fieldsets:
      - song
      # ... your other blocks
```

The block renders on the frontend via the bundled snippet (`snippets/blocks/song.php`). To customize the markup, copy it to `site/snippets/blocks/song.php` and edit it there — your version takes precedence.

### Fields

[](#fields)

FieldTypeNotes`source`filesAudio file (uses the `audio` file blueprint)`poster`filesPoster image (uses the `poster` file blueprint)`title`textSong title`subtitle`texte.g. artist or album`description`writerSupports bold and italic`controls`toggleShow player controls (default: on)`autoplay`toggleAdd the `autoplay` attribute (default: off)> **Note on autoplay:** modern browsers block audio autoplay with sound until the user has interacted with the page. Treat the autoplay setting as a hint — playback may not start automatically.

Development
-----------

[](#development)

```
npm install
npm run dev    # watch mode
npm run build  # production build (index.js / index.css)
```

Built with [kirbyup](https://github.com/johannschopplich/kirbyup).

License
-------

[](#license)

[MIT](LICENSE) © Ian Hobbs

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance99

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b982c8a97190d0b8f6de8a106a6f0970bdc619f8ae5accdb340942337e6cea4f?d=identicon)[ian hobbs](/maintainers/ian%20hobbs)

---

Top Contributors

[![ianhobbs](https://avatars.githubusercontent.com/u/1614350?v=4)](https://github.com/ianhobbs "ianhobbs (4 commits)")

---

Tags

audioblockkirbykirby-pluginkirby-cmsmusic

### Embed Badge

![Health badge](/badges/ianhobbs-song-block/health.svg)

```
[![Health](https://phpackages.com/badges/ianhobbs-song-block/health.svg)](https://phpackages.com/packages/ianhobbs-song-block)
```

###  Alternatives

[getkirby/cms

The Kirby core

1.5k606.6k541](/packages/getkirby-cms)[medienbaecker/kirby-modules

Easily add modules to your pages

895.6k1](/packages/medienbaecker-kirby-modules)[timnarr/kirby-imagex

Modern images for Kirby CMS – This plugin helps you orchestrate modern, responsive and performant images in Kirby

828.9k1](/packages/timnarr-kirby-imagex)[bnomei/kirby3-janitor

Kirby Plugin for running commands like cleaning the cache from within the Panel, PHP code or a cronjob

9343.5k2](/packages/bnomei-kirby3-janitor)[bnomei/kirby3-feed

Generate a Atom/JSON/RSS-Feed and XML-Sitemap from Pages-Collections

7228.0k](/packages/bnomei-kirby3-feed)[belugadigital/kirby-navigation

Kirby 5 field for hierarchical menus with drag & drop level indentation.

8615.1k](/packages/belugadigital-kirby-navigation)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)