1Bit Audio Player

What's that then?

1 Bit Audio Player is a very simple and lightweight Adobe Flash MP3 player with automatic JavaScript insertion. It's main purpose is to act as a quick in-page preview for audio files you link to from your website or blog.

The current version can be found at 1bit.markwheeler.net, while this is the development page.

Development

I've been re-writing the the Javascript to make 1Bit unobtrusive and generally improve it. The first version used jQuery, but has since ben re-written to make it smaller and more portable.

There's still some work to do, but the aim is to continue making 1bit easier to use; to play nice with other scripts and have smarter defaults so it needs less configuration.

Documentation

This is a little sparse at the moment, sorry.

There are 4 options, only the first is required and the other 3 are optional. Though it is recomended setting a value for 'color' as it defaults to #111111

oneBit.apply(selector, color[, background[, size])

'selector' is a CSS selector string to select the links you want to have a player. This supports most CSS2 and some CSS3 selectors.
'color' is the color the player icons will be. Specified as a full hex color code, including the #.
'background' is background color of the player. this defaults to transparent. Specified as a full hex color code, including the #.
'size' is the dimensions of of the player in pixels, by default 1bit will estimate the correct size. It's recommended you don't change this unless you encounter problems. There is only one value as height and width are the same.

The HTML it generates, and thus the elements/classes you have to play:


<span class="onebit_mp3">
	<a href="file.mp3">example</a>
	<span class="onebit_player" id="oneBitInsert_1">
		[Flash goes here]
	</span>
</span>

Notes

Re-write documentation
Have colour default to the link colour using getStyle() and converting the result to hex
OneBit.apply() should hide the differences of the DOM being loaded or not and remove the need for OneBit.read() entirely. This requires knowing if the DOM has loaded yet
Dean Edward's Packer is handy for compression.
Modal on the OneBit object to limit the script to mp3s on the local server only, to enforce politeness?

Demo

Here's an example mp3, the Sonic Emerald jingle. (Short and quick loading for easy testing).

A couple of songs from my good friend Simon Coltman.

Usage

Download 1bit.js

You'll need 1bit javascript and 1bit flash files, as well as the swfobject javascript, which 1Bit requires.

Then use like so (full documentation to come).


oneBit = new OneBit('flash/1bit.swf');

oneBit.ready(function() {
  oneBit.apply('.content a', '#263B83');
});