Slcnc Mini Player wiki

Download the latest version : https://sourceforge.net/projects/slcncminiplayer/files/?source=wiki

Slcnc Mini Player Documentation

Known Bugs :

None. If you have one to report you are more than welcome.

CHANGELOG :

Version 1.0.0.0.0.1

Some text files added. Please note that until today, it seems, although Sourceforge reported the download as being ok and the file being listed in the "Files" section of the project, the Version 1.0 archive never was availalble.

A new upload of V1.0 has been done and seems to work, for now.

The V1.0.0.0.0.1 archive seems to be downloadable, as well.

Note to myself : try to no longer forger to always alpha test any website while using it.

Version 1.0

Quick and dirty, but necessary update, mainly due to the fact that I got a Flattr microdonation a few time ago.

The "Download" link featured is not working currently. You may want to edit the embed.php file and delete the

<a href="(...)>download</a>

part to prevent it from being displayed.

Bug fixed, mp3-only browser (IE, Safari) support. Sorry for having letting this in the package till now, but I ain't got no Safari nor IE, Bug fixed for iframe-based streaming (very old browsers, I had told you it was experimental and partially tested). m3u streaming bug fixed (the last chance fallback, for more than very old browsers).

Read the embed.php file. Please do ! There's doc in it. Various improvements in the embed code generator.

Totally untested, just edited from the (working) code tailored for clewn.org ; it can as well not be interpretable by PHP due to a syntax error. You are the alpha tester !

Version 0.7
-corrected a bug introduced in 0.6 : the song and album sharing pages were also displaying tracks from the same artist outside the actual selection. Corrected.

Version 0.6
-added support for multi-artist albums (compilations, splits...)
-easier interface to generate embedable code

Version 0.5 :
-added easy to share song, album, artist pages, with share links below each song.
-added easy to share page for current player selection
-added support to integrate easily support for thid party sharing widget such as AddThis (FB like, tweet button, +1 button and so on)
-as a side effect, now you can have an embedable player just for one song or one album

Version 0.4 :
-minor bug fix for Elinks browser (when asked for more songs, it wasn't working. Fixed)
-minor multi-artist mode bug fixed (when asked for more songs in multi artist mode (but not in artist merging mode) the player switched back to single artist mode. Fixed)
-minor fix for the feature that allows your visitors to embed the player on their own site or blog (the form wasn't displaying correctly in some very special CSS environments. Fixed)
-shipped documentation updated

Version 0.3
-added fallback code (partially tested) to theorically support any browser as long as it can render iframes. First browsers supporting them appeared in 1997 and it was standardized in HTML 4.0.
-minor bug fix for audio file filenames with quotes in them.

version 0.2
-added fallback code expected to solve IE9 bug. It will also allow old browsers not supporting html5 audio but supporting direct mp3 file playback (like firefox < 3.0) to stream.

version 0.1
initial release

Browser support

Version 0.3 or newer should work on any browser supporting iframes ; fallbacks are
-if available, uses HTML5 audio tag
-or uses direct browser mp3 playback, if available
-or uses system media player software playback, trough m3u, if everything else fails

Firefox 13/linux : v0.1 -> 0.5 tested, working
IE9/windows :0.2 or newer should work. v0.1 reported not working
Firefox 14/windows : v0.1 reported working
Chromium 18/Linux :v0.1 -> 0.5 tested, poor audio quality
Elinks 0.12/Linux : v0.4 tested, working. v0.3 tested, working with minor bug

recent Safari, all OSes : all version should work
recent Opera, all OSes : all versions should work
older Safari, all OSes : 0.3 version or newer should work, 0.1 will not work, 0.2 status unknown
older Opera, all OSes ; 0.3 version or newer should work, 0.1 will not work, 0.2 status unknown
Firefox>3.0, all OSes : all versions should work
Firefox<3.0, all OSes : 0.2 or newer version should work
Chrome/Chromium, all OSes : all versions should work
Elinks, all OSes : 0.4 or newer should work. 0.3 should work with minor bug

Installation

To install Slcnc Mini Player on your website, download the latest version from SourceForge, and the latest version of php-getid3 (a free-licensed PHP library).

Ubuntu tip : install php-getid3 with the command "sudo apt-get install php-getid3" or with the software center.

Put the php files for php-getid3 in a place that your web server can acces and read from.

Edit the Slcnc Mini Player file named 'embed.php' to indicate where php-getid3 is located.

Also, follow the instructions indicated in it ("replace any xxx occurence by zzz") to reflect your actual site's domain name.

Install the Slcnc Mini Player php files on your web server's public web directory.

In the directory you'll have installed the Slcnc Mini Player files, create a sudbdirectory named 'audio'.

You may want to prevent people from listing its content by adding a .htaccess policy file or by other means.

In the 'audio' directory, each track must be available, with the same base name, in three formats :

ogg
mp3
flac

The flac files must be properly taggued with an ID3 tag editor that supports Vorbiscomments format, with at least the fields "Artist", "Album" and "Title" filled. Otherwise fallback will be to use mp3 or ogg tags, but this is partially tested only.

Point your browser to an address that reflects your site name and the place you installed the files, like http://yoursiteaddress.net/the-place-you-installed/player.php

Then use the form to generate the player code you can embed on most websites.

Full featured audio streaming will require a recent browser (Chrome, Firefox>3.0, Internet Explorer>9, typically a post-2008 browser). Basic streaming may work on older browser as well.

Please note that Slcnc Mini Player will allow any people with basic web skills to download your music for free, and there is no easy way to prevent this.

multiple artist merging

Slcnc Mini Player is configured, when asked for "Nicolas Chartoire" music, to also add music from Thcoreba Thmano, Still Living Creature, Nacso and Me In The Bath, and to display project name inside the player.

Edit the file "embed.php" by changing these band names to enable merging for your own project.

any artist selection

Now theorically supported by the embed code generator.

The wiki uses Markdown syntax.

Project Admins: