Some flashvars changed from the 3.x player, so if you have troubles upgrading check this list first!
This section describes a very simple installation. The download ZIP contains all you need to get started. First, transfer the player.swf and swfobject.js file from the ZIP to your website. Also upload all videos/songs/images you want to show to your site.
Second, embed the player in your HTML page with these lines of code. If you place the files in different directories, make sure to set the references in this code accordingly:
<p id='preview'>The player will show in this paragraph</p>
var s1 = new SWFObject('player.swf','player','400','300','9');
The flashvars parameter can contain a list of variables for configuring the player. To quickly get the ones you want, use the setup wizard. Select an example, set the variables you want and copy-paste the code to your page. That's all!
All documentation of the JW Player can be found at the JW Player Wiki. It also includes the roadmap, source code and bug tickets. A couple of direct links are here:
- All supported flashvars (variables) you can set to customize the player.
- All file, playlist and captioning formats you can use, plus some implementation info.
- An overview of all skinneable elements plus info on how to create a skin.
If you find a CMS module that embeds the player in existing CMS systems, please report!
Also make sure to check out the various tutorials on this site, including the ones on:
- Embedding a flash object in your site (which covers the simple embed method and the SWF Object method).
- Converting your video to FLV.
- Adding accessibility features (closed captions and an audio description) to the player.
I receive a lot of requests for creating customized versions of my player/rotator. In most cases however, a clever setting of the flashvars already fulfilled the requests, so please make sure you first check the list of flashvars or the setup wizard. Additionally, I do not design or program any particular (paid-for) customizations (I just don't have time for it), but interesting features will be plugged into the next update.
If you are familiar with actionscript (3) yourself, you should find that changing or adding to the player is quite simple. To get started, I've provided a PDF with clear overview of the application structure. All source code can also be checked out from the Wiki.
Here's a list with some frequently-encountered problems. For tips, tricks, additional info and bug reports, you can always have a look at my support forum.
- If you encounter too fast or too slow playback of MP3 files, it contains variable bitrate encoding or unsupported sample frequencies (eg 48Khz). Please stick to constant bitrate encoding and 11,22,33,44 kHz. The free iTunes software has a decent MP3 encoder.
- If the progressbar isn't running with your FLV file, or if your video dimensions are wrong, your FLV file doesn't have metadata. Fix this by using the small tool from www.buraks.com/flvmdi/.
- If FLV playback doesn't work on your site which runs off an IIS server, the FLV mimetype isn't added to the server. Please contact your webserver administrator on this (if you're an admin, here's how to fix it).