Choon Player

Description

Choon Player is a simple audio player that supports loops and slowing down music for learning by ear. It was developed for learning Irish Traditional music. It supports two players:

  1. A player for MP3 files. To display the player, put a valid URL pointing to an MP3 or M4A recording between the shortcodes [choon] and [/choon] on your page or post.

  2. A player for ABC notation. To display the player, put valid ABC notation between the shortcodes [choon-abc] and [/choon-abc] on your page or post.

Where can this be used?

Anywhere that shortcodes are accepted. Tested on pages but not on post or widgets using the Neve theme. Some CSS adjustment likely needed with other themes.

How does it work?

The plugin includes the [choon] and [choon-abc] JavaScript libraries. The URL or ABC notation that is put in the shortcode is passed to the relevant library, which places the player on the page instead of the shortcode.

What can be put in the url that is placed in the [choon] shortcode?

A pointer to an MP3 file. Other audio formats supported by the HTML5 audio player should also work.

What can be put in the block of text that is placed in the [choon-abc] shortcode?

A block of valid ABC text. See https://thesession.org for examples.

What parameters may be used?

At this stage, none!

Thanks

Special thanks to Paul Rosen for all his work on abcjs. The WordPress plugin parts of this code were based on his excellent ABC Notation plugin. Any bugs or features are all my own work!

The javascript code was based on the players used on the Wellington
Irish Sessio

All the code for that site is available at:
https://github.com/slow-session/wellington.session.nz

Screenshots

  • screenshot-1.png
  • screenshot-2.png

Installation

  • Download the WordPress plugin available from https://wordpress.org/plugins/choon-player/

or

  • Upload the contents of the GitHub archive at
    https://github.com/slow-session/choon-player to the /wp-content/plugins/choon-player/ directory.

Activate the plugin through the ‘Plugins’ menu in WordPress.

FAQ

Not yet!

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Choon Player” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Choon Player” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

0.0.1

  • Initial version

0.0.2

  • Minor tidyup of php code to simplify it

0.0.3

  • Now supports more than one tune per page – lots of tunes on the same page are not a good idea!

0.0.4

  • Add a ‘choon’ prefix to function and other variable names to avoid clashes
  • Load additional libraries from local sources

0.0.5

  • Minor changes to support Choon Player’s addition to the WordPress
    plugin scheme

0.0.6

  • Added support for URLs with non-ASCII characters e.g. accents in
    Irish, Scots Gaelic etc

0.0.7

  • Fixed the link to the “play” and “pause” buttons

0.0.8

  • updated choon-player.js to use “module.exports”

0.1.0

  • added support for a simple ABC player with similar features to the MP3 player

0.1.1

  • strip any lyrics from ABC notation (lines that start with ‘w:’) as
    they mess up tune length calculations

0.1.2

  • fix version number

0.1.3

  • add to documentation

0.2.0

  • upgrade code to allow more than one instance of the shortcodes of each page

0.2.1

  • remove unwanted parametes from some functions

0.2.2

  • tested against WordPress 5.7

0.2.3

  • Improve playback of multiple ABC tunes in a single [choon-abc] tag

0.2.4

  • Explicitly load MP3 file on playback – avoids long session with webserver