jPlayer

HTML5 Audio & Video for jQuery

a project by happyworm

Support

Join us on gitter and ask a question.

We provide support for jPlayer through the jPlayer Google Group.

When asking for support, please provide:

  • A detailed description of your issue,
  • A link to your development website,
  • The browser and its version, where you have the issue.

FAQ

Is there a tutorial to help us get started?
Yes. The Quick Start Quide gives a step by step description of how to use jPlayer.

Where can I get the demo files?
The download page has a demos ZIP available that contains all the demos with the jPlayer.org page template removed. Place these files on your localhost server or web server, and you will have a working set of demos to start working with.

Is there documentation for the jPlayerPlaylist add-on?
Yes. See this jPlayerPlaylist demo.

Why do my MP3/M4A files not play in Firefox 3.6?
Make sure you use the option {wmode:"window"} so that the Flash fallback is instanced using the correct wmode. This problem does not affect Firefox 4+ and the default wmode works. Video players are not effected by this issue.
This circumstance occurs when you only supply MP3/M4A formats.

Why does my player not work in Internet Explorer 6/7/8?
Your swfPath is incorrect, which causes the Flash fallback to fail.
This circumstance occurs when you supply MP3/M4A and OGA formats. Or for video, M4V and OGV formats.

Why does my player not work in Internet Explorer 6/7/8, Firefox and Opera?
Your swfPath is incorrect, which causes the Flash fallback to fail.
This circumstance occurs when you only supply either MP3/M4A or M4V formats.

Why does my player not work in Internet Explorer 6/7?
You have a trailing comma in your JSON code.

Why does my player not work in Firefox (win), Opera or IE9+?

  • Your MP3 MIME type is incorrect. Correct to audio/mpeg
  • Your MP4/M4A/M4V MIME type is incorrect. Correct to audio/mp4 or video/mp4
  • Your OGA/OGV MIME type is incorrect. Correct to audio/ogg or video/ogg

Why does my player not work in OSX Safari?
The MP3/Mp4 media is encoded incorrectly. Review how Safari plays the media by directly accessing the media url. The media will need to be re-encode to solve this problem. (The exact encoding problem is unclear.) An alternative solution is to use {solution:"flash,html"}

Why does my player not work in Win XP Firefox 3.5/3.6?
The OGG media is encoded incorrectly. Review how Firefox plays the media by directly accessing the media url. The media will need to be re-encode to solve this problem. (The exact encoding problem is unclear.)

Why do my progress bars not work in Chrome?
You disabled caching of the media using the media's server response. This causes the duration to be unknown. If you cannot correct the server response, an alternative solution is to use {solution:"flash,html"}

I'm sure my swfPath is correct, but the Flash fallback still does not work. Why?

  • Did you upload the Jplayer.swf file? - Check!
  • Did you upload the current Jplayer.swf version?
    • Either from the same Plugin ZIP file that contained the JavaScript or from the current GitHub version.
    • Visit the Jplayer.swf URL directly in your browser, and it will show its version.
    • If visiting the Jplayer.swf URL directly does not show a version, then update your plugin!
  • Are you using Flash 10.1 or above? - Check your version.
    • Did you delete the HTML for the no-solution event?

I have checked everything! Why does my site still not work?
Check that you only included jQuery once. Including it more than once will usually corrupt part of your code and give varying results cross-browser.

jPlayer uses HTML5, why do I need the Jplayer.swf file and swfPath?
Older browsers play media through a Flash fallback.

Firefox and Opera are HTML5 browsers, why are they using jPlayer's Flash fallback?
These browsers require the OGG format OGA and OGV files to play media using HTML5.

Why does iOS/Android not auto-play?
Mobile browsers will not download any media until it is requested by the user. This means that the user must at least touch the screen to allow the media to play. This gesture must be associated with the play command, such as touching the play button.

Can jPlayer play SHOUTcast streams?
Yes. It works best with MP3 streams. M4A (AAC) streams can have problems with the flash solution if no metadata is given when connecting to the stream.

How do I get jPlayer to play a SHOUTCast stream?
You need to setMedia to the stream URL. For example,
SHOUTcast server: http://mp3-vr-128.as34763.net/
MP3 stream URL: http://mp3-vr-128.as34763.net/;stream/1

My SHOUTCast stream does not work in browser X?
HTML5 browsers sometimes have problems with streams. The Flash fallback tends to work better x-browser. Use {solution:"flash,html"} if your find your stream does not work in some HTML5 browsers.

I serve my media through a PHP portal, but cannot get byte Range requests to work. Help!

Troubleshooting

Developer Tools. Learn to love them!

  • Firefox: Firebug add-on
    A great all rounder. The net tab can disable cache and allow you to review server response and MIME types easily. The console will report most errors, and you have all the HTML and CSS features to aid you develop your site. Search the add-ons for Firebug and install the add-on and then turn on all the features you desire tab by tab.
  • Opera: Dragonfly
    A great tool for finding JavaScript errors. Sometimes Firebug will not report errors in jQuery event handlers.
  • Safari / Chrome: Developer Tools
    Do not give server response details on media requests.

Check that your Flash fallback is configured!
If you want to check that your swfPath is correct for older browsers, set the option {solution:"flash,html"} and then test that the Flash fallback works in Firefox. Use Firebug to ensure the Jplayer.swf file is not giving a 404 error. If it is, your swfPath is incorrect or your file is missing.
After testing your swfPath, return the solution option to the value you want.

Check that media plays directly in a browser!
If you find that a browser does not play your media, you can visit the media URL directly to see if the HTML5 native player works. You will need to know whether your browser can play that format in the first place. Here is a brief summary:
MP3/M4A/M4V: Safari, IE9 and Chrome. (Until Chrome drops H.264 support required for M4V.)
OGA/OGV: Firefox, Opera and Chrome.
Note that, for example, Firefox playing an MP3 in the QuickTime plugin does not count as native playback!