Help:Players

From MixesDB
Jump to: navigation, search

This page explains how to embed players using the Editor button - Player.png button.

Audio players

If a mix is available on one of the following websites you can include the player in the File Details section of the belonging mix page. To do so, use the {{Player|}} template and simply enter the URL. It should be placed between the "File Details" table and the "Notes & Tracklist" headline.

Once added to the mix page, the player will also appear on other relevant pages like MixesDB:Explorer/Players.

SoundCloud

Simply copy the URL of the SoundCloud player site.

{{Player|http://soundcloud.com/thomas-schumacher/july-podcast-mix}}  returns:

Note: Don't copy durations from SoundCloud players. They're always wrong by a few seconds.

SoundCloud sets are not supported. Use Multiple players instead.

Private players (example) are not allowed for embedding. Some uploaders want players only on their own website. That's ok and we respect that. You can detect such private players on the missing share button and the secret token at the end of the URL: http://soundcloud.com/factmag/fact-mix-314-guido-jan-12/s-fll4z

Mixcloud

We need the website URL: {{Player|http://www.mixcloud.com/funkdvoid/funk-dvoid-drum-bass-memories/}}  returns:

Mixcloud dates: In your address bar replace www. with api. and look for the "created_time"-field.

Note: Use our Mixcloud pimp script to browse mixloud.com more comfortable.

Btw: It's "Mixcloud", not "MixCloud".

play.fm

We need the widget URL part of the share code, e.g. {{Player|https://www.play.fm/widget/35490}}  returns:

Here's how to grab it.

You can also use our Pimp scripts to display it directly (Pimp Bundle 2).

PodOmatic

We need the URL of the podcast's "Permalink" (http://.../entry/2017-...).

{{Player|https://podomatic.com/embed/html5/episode/8312192}}  returns:

The perma URLs like https://www.podomatic.com/podcasts/freerangerecords/episodes/2017-01-09T04_46_48-08_00 work as well.

Direct Players

For selected podcasts it is possible to add players using their direct mp3 URL. To find out which websites / podcasts are allowed, see Category:Direct Players.

{{Player|http://daten.clr.net/pod/CLRSR242_Monoloc.mp3}}  returns:

We're fair players so we contacted the people behind each podcast and asked for an official authorization to add players for their podcast files.

If you want your domain whitelisted for your own promo mixes: Post in the forum, please.

Other Audio Players

hearthis.at: We need the short URL, e.g. {{Player|https://hearthis.at/74940/}} or the share URL, e.g. {{Player|https://hearthis.audio/74940/}}. Screenshot

HulkShare: We need the short URL, e.g. http://hu.lk/qbhc8vrpnzsw.

Podbean.com: We need the download URL, e.g. {{Player|http://techniqueuk.podbean.com/mf/feed/xc3pb6/Technique016-Hrdvsion.mp3}}
The original embeddable player is so ugly that we use a default player instead.

Internet Archive: We need the URL of the mp3 listed in the "audio files" table, e.g. {{Player|http://www.archive.org/download/DJLpodcast054_-_Kaiserdisco/DJLpodcast054_-_Kaiserdisco.mp3}} Screenshot

bandcamp.com: We need the page URL and the file ID (grab it from the bandcamp player embed code, e.g. .../track=1974566170/...), e.g. {{Player|http://firstsecond.bandcamp.com/track/xox|id=1974566170}}
Other websites can use the Bandcamp player on their site. We need to whitelist their domain. An example from familiespodcasts.audiofamilies.com: {{Player|http://familiespodcasts.audiofamilies.com/track/i-cube-nova-mix-nov-11|id=3143944047}}

France Inter: We need the URL of the pop-up player, e.g. {{Player|1=http://www.franceinter.fr/player/reecouter?play=579441}}. Not all episodes of a show have a player.

Beatport Mixes: We need the page URL, e.g.

  • {{Player|http://mixes.beatport.com/mix/id/137313}}
  • {{Player|http://mixes.beatport.com/mix/dim-mak-presents-dirtyphonics-beatport-mix/36789}}
  • {{Player|https://www.beatport.com/unrilisofficial/mixes/khutndi9gcbs/cari-lekebusch-complex-excl-unrilis-guest-mix}}

audiomack: We need the page URL, e.g.

  • {{Player|https://www.audiomack.com/song/goldenyearz/tresornight-vom-07april1996-in-hoyerswerda}}
  • Known issues

Which is the best?

Streams original file quality Offers download Direct skipping 1) Player loads HTML5 2) Nice features Summary
SoundCloud no (128 kbps mp3) yes (fast) yes fast yes Remembers last position 3) Fast and community comments, but files (and their comments) are deleted too often for different reasons. Uploading more than a few hours of music gets expensive. The player is "HTML5 ready" (incl. favoriting and commenting inside player) but currently very buggy.
Mixcloud no (~64 kbps m4a) no yes fast yes Remembers last position 3) Low sound quality, buggy skipping and no download, but unlimited uploads.
hearthis.at no (128 kbps mp3) yes yes fast yes Reduced stylish player and good sound.
play.fm no (128 kbps) no yes fast no Besides the fast direct skipping it has almost no advantage.
PodOmatic yes yes (but hidden) yes slowly no Nice player if it was faster, but the player has no download button.

The download link is hidden on the bottom of the page.

samurai.fm yes (?) no yes (but long delay) slowly no Direct skipping, but no download.
Internet Archive yes yes (slow) no (and slow buffering) fast yes, via Direct Player The service should be used much more because uploaded files (by the respective copyright owners) are hosted forever.
Direct Players yes yes no fast yes, if browser support 4) The player is stable and loads fast. The original file quality is streamed.

1) Direct skipping ("HTTP Pseudo-Streaming") = Jumping into any position of the track bar without waiting for the stream file to download into the browser's cache.

2) HTML5 players are more user friendly and stable than evil flash players. Less Flash = less crash.
"HTML5 ready": Open source browsers like Firefox can't play mp3 in HTML5 by default. That means that the HTML5 player itself is HTML5 and no flash, but for streaming the mp3 the player uses Flash in the background. The solution would be that player websites encode uploaded mp3 files to free formats such as OGG Vorbis for embedded player streaming.

3) If you play the mix some other time again, it will start at the position you stopped last time (e.g. by leaving the page).

4) If the Direct Player file is an mp3 and your browser supports mp3 playback in HTML5 (e.g. Chrome) then the player will fallback to HTML5, otherwise Flash is used.


So decide yourself which player to add. Mix pages should not display more than 2 different players for the same mix file. Alternative links should be added in a <!-- hidden comment --> as a backup to replace deleted players ( example).

Video players

Videos can be embedded if they are complete sets and official (legally uploaded and no homemade fan videos by somebody unrelated).

Videos have different dimension ratios. Our player width is fixed to 445 pixels, so to avoid black stripes

on top or on the side, you can use h= to override the default 252 px height.

If the video is audio only use |video=audio (see below).

YouTube

Don't add short clips! We only embed full sets. For embedding you need to add 1= in front of the URL:

{{Player|1=http://www.youtube.com/watch?v=qciVXUHTN10|h=277}} (example returns:

YouTube's share URLs like http://youtu.be/qciVXUHTN10 are working as well (doesn't require 1=). How to copy them.

Often full sets are split into single parts. You can embed their playlist:

{{Player|1=http://www.youtube.com/view_play_list?p=D9167CDF365A7458|h=360}} (example returns:

Grabbing YouTube images

Get the ID, e.g. from http://www.youtube.com/watch?v=FDcqgy286Ug and insert it to the URL like this: http://img.youtube.com/vi/qciVXUHTN10/0.jpg

Vimeo

{{Player|http://vimeo.com/7964034}} (example returns:

Override the default height: Click on "embed" on the vimeo player and "customize" it. It should look like this. In the width field enter "445". The height should be updated automatically there. Add this height to the Player template with h=:

{{Player|http://vimeo.com/8694851|h=334}} (example returns:

b@TV

For b@TV videos we need the short URL, e.g. http://www.be-at.tv/EMYFAA.

On the player page you can grab it by clicking the "share" option on the upper right: Screenshot

{{Player|http://www.be-at.tv/EMYFAA}} returns:

Note: Use our b@TV pimp script to grab the embed URL easily.

Other video players

We also allow other web players which are not used very often.

VK the embed iframe URL, e.g. //vk.com/video_ext.php?oid=-26798882&id=456239237&hash=af81f2c5a53e4ea0&hd=2 Screenshot

You can also use our Pimp scripts to display it directly (Pimp Bundle 1).

Dailymotion: the page URL, e.g. {{Player|http://www.dailymotion.com/video/xjtti0_deadmau5-live-roskilde-festival-2011-full-set_music}}

ARTE concert: e.g. {{Player|http://concert.arte.tv/fr/player/27446}} How to grab the code.

promodj.com (PDJTV): the page URL, e.g. {{Player|http://promodj.com/PDJTV/videos/4247172/PDJTV_ONE_Robert_Babicz}}

France TV / Culturebox: the embed URL, e.g. http://embed.francetv.fr/?ue=490a2824cb366d5216765c68dab57cf1

Player titles

If only a part / artist or a certain version is available on SoundCloud, it should be clear which the player contains. Therefor add the artist's name or the version as second parameter into the template, e.g. {{Player|URL|Artist}}. Examples: Artist / Version.

Note: The info has to be entered this way so everything can be displayed correctly on categories and MixesDB:Explorer/Players.

Multiple players

You can use a multiple player setup (example):

{{Player|mode=multi
 |http://soundcloud.com/paxahau/02-03-01_kevinyost_motor_pt1-1
 |http://soundcloud.com/paxahau/02-03-01_kevinyost_motor_pt2-1
}}

returns:

You can also set titles for each player using the t-parameter (t for "title" or "tab") and may use 1= and 2= etc. if it gets too confusing (example):

{{Player|mode=multi
 |http://soundcloud.com/ninja-tune/solid-steel-radio-show-18-11-1|t1=Orangewarrior
 |http://soundcloud.com/ninja-tune/solid-steel-radio-show-18-11|t2=Ruckus Roboticus
}}

returns:

You can combine up to 12 players this way. It doesn't have to be used on every page with two players like this, but it should on pages with 3 or more players and on standard shows with guest DJs like Solid Steel.

Mirrors

If there are different players of the same file, you can use |mode=mirrors.

The titles are added automatically, but can be overriden if needed with the |t= parameter.

It shouldn't be used for

  • multiple players from the same website
  • different direct player websites
  • players with different file versions
  • files with multiple parts

Audio + video player

If audio and video players are available for the same mix, both can be embedded. If the audio is a rip of the video, it should be stated as such (example):

{{Player|mode=multi
 |1=http://www.youtube.com/watch?v=Uaq285eGnLA|h1=335|t1=Video
 |2=http://soundcloud.com/m_p_m/1996-05-26-daft-punk-live-even-further-wisconsin|t2=Video rip
}}

returns:

See also Multiple players.

More examples:

Video player = audio only

If not stated otherwise, players like YouTube, Vimeo or b@TV are added to Category:Video Players by default.

If the video is audio only (example), then it shouldn't appear in Category:Video Players. |video=audio will add it to Category:Audio Players instead (more examples).

Single video

{{Player|http://youtu.be/0oDQ4HQzWoI|video=audio}}

returns:


Single video with title

{{Player|http://youtu.be/JNSt8XmrcOY|video=audio|t=DJ Rush}}

returns:


Mirrors with YouTube Note that |video=audio is added on top without numbering so all video players are ment to be audio only.

{{Player|mode=mirrors|video=audio
 |http://soundcloud.com/d2techno/tronic-podcast-030-with-wehbba
 |http://www.mixcloud.com/christiansmithlive/tronic-podcast-030-with-wehbba/
 |https://www.youtu.be/8AZcUva5zHM
}}

returns:


There can be cases where we have a real video and a video rip uploaded on e.g. YouTube. Then you'd need to number the video parameter, e.g. |video3=audio.

Fictional example:

{{Player|mode=mirrors
 |1=http://www.be-at.tv/embed.swf?p=334226
 |2=http://www.mixcloud.com/livesetsdjmixes/joseph-capriati-live-shelborne-hotel-waveform-pool-party-wmc-miami-23-03-2013/
 |3=https://www.youtu.be/something|video3=audio
}}

returns:

Player categories

Mix pages with players are automatically categorized into hidden categories:

A mix page using a SoundCloud player is categorized into Players, Audio Players and SoundCloud. This makes sure we can properly handle the players on e.g. MixesDB:Explorer/Players.

FAQ

When to use 1=?

1= is required whenever the URL you add uses =, e.g. http://www.youtube.com/watch?v=qciVXUHTN10.