PHPackages                             hashandsalt/kirby-gilmour - 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. [File & Storage](/categories/file-storage)
4. /
5. hashandsalt/kirby-gilmour

ActiveKirby-plugin[File & Storage](/categories/file-storage)

hashandsalt/kirby-gilmour
=========================

Kirby 3 Gilmour Plugin for working with files iwth ID3 tags

v0.0.7(7y ago)5991[1 issues](https://github.com/HashandSalt/Kirby3-Gilmour/issues)MITPHP

Since May 10Pushed 5y agoCompare

[ Source](https://github.com/HashandSalt/Kirby3-Gilmour)[ Packagist](https://packagist.org/packages/hashandsalt/kirby-gilmour)[ RSS](/packages/hashandsalt-kirby-gilmour/feed)WikiDiscussions master Synced 2mo ago

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

Kirby Gilmour : Work Audio file ID3 Data
========================================

[](#kirby-gilmour--work-audio-file-id3-data)

A small plugin to with ID3 tags on audio files.

Features:

- File method for querying the file directly and getting the info straight from the ID tag.
- File hook that pulls the most useful into into a file meta on upload. This is quicker to retrieve later.
- Capable of ripping the Album Cover image embedded in the tag and storing it as a file in the panel (Oh yes!).

---

Commercial Usage
----------------

[](#commercial-usage)

This plugin is free but if you use it in a commercial project please consider to

- [make a donation 🍻](https://paypal.me/hashandsalt?locale.x=en_GB) or
- [buy a Kirby license using this affiliate link](https://a.paddle.com/v2/click/1129/36141?link=1170)

---

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

[](#installation)

### Download

[](#download)

Download and copy this repository to `/site/plugins/kirby-gilmour`.

### Composer

[](#composer)

```
composer require hashandsalt/kirby-gilmour

```

How to use Gilmour
------------------

[](#how-to-use-gilmour)

First, of course, you need some audio files on your page, and optionally, setup a files blueprint to store data. You can use the one in the plugin by extending it into your own blueprints, or just copy it and use it as a starting point.

The following information will be available:

- album
- artist
- title
- track
- composer
- genre
- year
- duration

Ripping Cover art
-----------------

[](#ripping-cover-art)

You can toggle the generation of album cover artwork, and set the blueprint for cover art images by adding the following options to your config:

```
'hashandsalt.gilmour.ripcover' => true,
'hashandsalt.gilmour.imagetemplate' => 'imageart',

```

Usage
-----

[](#usage)

You can use the file method to get the data directly from an audio file:

```

```

Or you can use the data fetched by the hook:

```

```

To get the cover art image:

```