Archive:PAPlayer: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Spiff
>Gamester17
No edit summary
Line 1: Line 1:
'''PAPlayer''' (or '''PAP''' for short) stands for '''Psycho-acoustic Audio Player'''.
'''PAPlayer''' (or '''PAP''' for short) stands for '''Psycho-acoustic Audio Player''', and it is XBMC's own in-house developed audio-player.
PAP began as a pure mp3player using Winamp's in_mp3.dll for decoding (around 12th of April 2005), but only a few weeks later has evolved into a multicodec musicplayer.
PAP originally began as a pure MP3-player using WinAmp's ''in_mp3.dll'' for decoding (around 12th of April 2005), but only a few weeks later evolved into a fully-fledged multi-codec music-player.
 
=Features=
When this page was last updated (Mar 13th 2006) it has the following features:
When this page was last updated (Mar 13th 2006) it has the following features:
===Currently Supported Codecs===
==Currently Supported Codecs==
'''(.dll's must be placed under the [XBMCFOLDER]/system/players/paplayer subfolder for the listed music format to become active)'''
'''(.dll's must be placed under the [XBMCFOLDER]/system/players/paplayer subfolder for the listed music format to become active)'''
* [http://en.wikipedia.org/wiki/Advanced_Audio_Coding AAC] aka LC-AAC and also [http://en.wikipedia.org/wiki/HE-AAC AAC+] aka HE-AAC (needs AACCodec.dll from SVN) Based on [http://www.audiocoding.com/ faac] '''(see i. below)'''
* [http://en.wikipedia.org/wiki/Advanced_Audio_Coding AAC] aka LC-AAC and also [http://en.wikipedia.org/wiki/HE-AAC AAC+] aka HE-AAC (needs AACCodec.dll from SVN) Based on [http://www.audiocoding.com/ faac] '''(see i. below)'''
Line 24: Line 26:
* [http://www.xboxmediacenter.com/wiki/index.php?title=HOW-TO:_Play_game_audio_direct_from_source_(DVD/HDD) XBADPCM] XBOX ADPCM game audio (ADPCM.dll) [http://aluigi.org/papers.htm#xbox Xbox ADPCM plugin 0.1.2]
* [http://www.xboxmediacenter.com/wiki/index.php?title=HOW-TO:_Play_game_audio_direct_from_source_(DVD/HDD) XBADPCM] XBOX ADPCM game audio (ADPCM.dll) [http://aluigi.org/papers.htm#xbox Xbox ADPCM plugin 0.1.2]


===Currently supported players===
==Currently supported players==
* [http://www.lim.com.au/ImpulseTracker/ IT] short for Impulse Tracker (needs dumb.dll from SVN) Based on [http://dumb.sourceforge.net/ D.U.M.B 0.93]
* [http://www.lim.com.au/ImpulseTracker/ IT] short for Impulse Tracker (needs dumb.dll from SVN) Based on [http://dumb.sourceforge.net/ D.U.M.B 0.93]
* [http://en.wikipedia.org/wiki/ScreamTracker S3M] short for Scream Tracker 3 (needs dumb.dll from SVN) Based on [http://dumb.sourceforge.net/ D.U.M.B 0.93]
* [http://en.wikipedia.org/wiki/ScreamTracker S3M] short for Scream Tracker 3 (needs dumb.dll from SVN) Based on [http://dumb.sourceforge.net/ D.U.M.B 0.93]
Line 38: Line 40:
* [http://en.wikipedia.org/wiki/Midi MIDI] music (needs timidity.dll from SVN) Based on [http://en.wikipedia.org/wiki/TiMidity Timidity] '''(see v. below)'''
* [http://en.wikipedia.org/wiki/Midi MIDI] music (needs timidity.dll from SVN) Based on [http://en.wikipedia.org/wiki/TiMidity Timidity] '''(see v. below)'''


===Currently supported tagstandards===
==Currently supported tag-standards==
* APEv1
* APEv1
* [http://en.wikipedia.org/wiki/APEv2_tag APEv2]
* [http://en.wikipedia.org/wiki/APEv2_tag APEv2]
Line 46: Line 48:
* Vorbis Comments (used by Ogg & Flac)
* Vorbis Comments (used by Ogg & Flac)


===Other PAP features worth mentioning are===
==Other PAP features worth mentioning==
* [http://shibatch.sourceforge.net/ SSRC] resampling from 44.1kHz to 48kHz (Xbox hardware can only process 48kHz audio)
* [http://shibatch.sourceforge.net/ SSRC] resampling from 44.1kHz to 48kHz (Xbox hardware can only process 48kHz audio)
* [http://en.wikipedia.org/wiki/Gapless Gapless] support (means if audio is ripped in a certain way, it will playback without gaps)
* [http://en.wikipedia.org/wiki/Gapless Gapless] support (means if audio is ripped in a certain way, it will playback without gaps)
Line 56: Line 58:
|
|


===Supported protocols===
==Supported network-protocols and file-system formats==
* smb:// (Samba)
* smb:// (Samba)
* xbms:// (CCX)
* xbms:// (CCX)
Line 67: Line 69:
|valign="top"|
|valign="top"|


===Unsupported Protocols (handled by mplayer)===
==Unsupported network-protocols (today handled by MPlayer)==
* daap:// (iTunes)
* daap:// (iTunes)
* http://
* http://
|}
|}


===Some general info about PAP===
=Some general information about PAP=
When any or all of above codecs are not installed in its proper place, Mplayer will handle playback instead (if Mplayer supports the format).
When any or all of above codecs are not installed in its proper place, MPlayer will handle playback instead (if MPlayer supports the container format and codec).
Mplayer is not built for pure audioplayback and you will loose many advantages (features) that PAP has.
MPlayer is not built for pure audio-playback and you will loose many advantages (features) that PAP has.


===Known Issues===
==Known PAP issues==
'''i.'''  There's alot of confusion regarding the MP4/[http://www.m4a.com/ M4A] file extensions for audio files. Rename the .mp4 (or .m4b) extension to .m4a if you want PAPlayer core to be able to play it, otherwise the [[MPlayer]] core will handle playback. '''Also worth mentioning, PAP does NOT support DRM'd (Apple iTunes store) music files, (these usually have the extension .m4p).''' Plain .aac files works without issues.<br>
'''i.'''  There's alot of confusion regarding the MP4/[http://www.m4a.com/ M4A] file extensions for audio files. Rename the .mp4 (or .m4b) extension to .m4a if you want PAPlayer core to be able to play it, otherwise the [[MPlayer]] core will handle playback. '''Also worth mentioning, PAP does NOT support DRM'd (Apple iTunes store) music files, (these usually have the extension .m4p).''' Plain .aac files works without issues.<br>
'''ii.''' The APE decoder does not like files with the highest compression, they will play, but it can take quite a while to start them, which results that they are no longer gapless.<br>
'''ii.''' The APE decoder does not like files with the highest compression, they will play, but it can take quite a while to start them, which results that they are no longer gapless.<br>
Line 83: Line 85:
'''v.''' Put configuration file at q:\system\players\paplayer\timidity\timidity.cfg.
'''v.''' Put configuration file at q:\system\players\paplayer\timidity\timidity.cfg.


===Troubleshooting===
=Troubleshooting=
If you find that a codec unsupported by Mplayer does not play (or even show up in filelist), and you checked that you have the appropriate codec in ''<nowiki>[XBMCFOLDER]/system/players/paplayer</nowiki>'', chances are that you did not update (add new .extension) to the [[advancedsettings.xml#.3Cmusicextensions.3E|<musicextensions>]] of [[advancedsettings.xml]].
If you find that a codec unsupported by Mplayer does not play (or even show up in filelist), and you checked that you have the appropriate codec in ''<nowiki>[XBMCFOLDER]/system/players/paplayer</nowiki>'', chances are that you did not update (add new .extension) to the [[advancedsettings.xml#.3Cmusicextensions.3E|<musicextensions>]] of [[advancedsettings.xml]].


[[category:Inner Workings]]
[[category:Inner Workings]]

Revision as of 20:55, 19 March 2008

PAPlayer (or PAP for short) stands for Psycho-acoustic Audio Player, and it is XBMC's own in-house developed audio-player. PAP originally began as a pure MP3-player using WinAmp's in_mp3.dll for decoding (around 12th of April 2005), but only a few weeks later evolved into a fully-fledged multi-codec music-player.

Features

When this page was last updated (Mar 13th 2006) it has the following features:

Currently Supported Codecs

(.dll's must be placed under the [XBMCFOLDER]/system/players/paplayer subfolder for the listed music format to become active)

  • AAC aka LC-AAC and also AAC+ aka HE-AAC (needs AACCodec.dll from SVN) Based on faac (see i. below)
  • AC3-CDDA (needs AC3Codec.dll from SVN) Based on liba52
  • AC3-WAV (needs AC3Codec.dll from SVN) Based on liba52
  • AIFF short for Audio Interchange File Format (builtin)
  • ALAC aka Apple Lossless (needs AACCodec.dll from SVN) Based on alac
  • APE aka Monkey's Audio (needs MACDll.dll from SVN) Based on MAC (see ii. below)
  • DTS-CDDA (needs DCACodec.dll from SVN) Based on libdca (see iii. below)
  • DTS-WAV (needs DCACodec.dll from SVN) Based on libdca (see iii. below)
  • CDDA aka Audio CD playback, Red Book standard (builtin) Based on libcdio
  • FLAC aka Free Lossless Audio Codec (needs libFLAC.dll from SVN) Based on LibFlac
  • MP2 MPEG-1 Audio Layer2 (needs MADCodec.dll from SVN) Based on libmad
  • MP3 MPEG-1 Audio Layer3 (needs MADCodec.dll from SVN) Based on libmad
  • MPC aka Musepack aka Mpeg+ (needs libmpcdec.dll from SVN) Based on libmpcdec 1.2.2
  • OGG VORBIS (needs vorbisfile.dll from SVN) Based on vorbis
  • SHN aka 'shorten' (needs libshnplay.dll from SVN) Thanks to Holger Stenger for the dll!
  • WAV or WAVE, short for WAVEform audio format (builtin)
  • WavPack (needs wavpack.dll from SVN) Based on wavpack
  • WMA Windows Media Audio (builtin)
  • XBADPCM XBOX ADPCM game audio (ADPCM.dll) Xbox ADPCM plugin 0.1.2

Currently supported players

  • IT short for Impulse Tracker (needs dumb.dll from SVN) Based on D.U.M.B 0.93
  • S3M short for Scream Tracker 3 (needs dumb.dll from SVN) Based on D.U.M.B 0.93
  • MOD short for Amiga Module (needs dumb.dll from SVN) Based on D.U.M.B 0.93
  • XM Fast Tracker 2 (needs dumb.dll from SVN) Based on D.U.M.B 0.93
  • NSF NES Sound Format (needs NoseFart.dll from SVN) Based on Nosefart
  • SPC SPC700 sound file (needs snesapu.dll from SVN) Based on alpha-ii's snes APU
  • GYM Genesis music file (needs gensapu.dll from SVN) Based on gens apu
  • SID Commodore 64 Music (needs libsidplay2.dll from SVN) Based on libsidplay2+resid
  • Adlib OPL2/3 FM Music (needs adplug.dll from SVN) Based on adplug (see iv. below)
  • YM ATARI ST music (needs stsoundlibrary.dll from SVN) Based on st sound
  • ADX/AST/ADP/DSP/YMF/HPS Gamecube ADPCM compressed music (needs cube.dll from SVN) Based on in_cube
    (NOT related to XBOX or PS2 ADPCM)
  • MIDI music (needs timidity.dll from SVN) Based on Timidity (see v. below)

Currently supported tag-standards

Other PAP features worth mentioning

  • SSRC resampling from 44.1kHz to 48kHz (Xbox hardware can only process 48kHz audio)
  • Gapless support (means if audio is ripped in a certain way, it will playback without gaps)
  • Crossfade tracks (adjustable 1–10 seconds)
  • ReplayGain support
  • Cuesheet support (.cue files) for any supported codec.
  • Ogg Chapter support

Supported network-protocols and file-system formats

  • smb:// (Samba)
  • xbms:// (CCX)
  • cdda:// (AudioCD)
  • iso9660://
  • udf://
  • lastfm:// (Last.FM Radio)
  • shout:// (Shoutcast)
  • Local (Harddisk)

Unsupported network-protocols (today handled by MPlayer)

  • daap:// (iTunes)
  • http://

Some general information about PAP

When any or all of above codecs are not installed in its proper place, MPlayer will handle playback instead (if MPlayer supports the container format and codec). MPlayer is not built for pure audio-playback and you will loose many advantages (features) that PAP has.

Known PAP issues

i. There's alot of confusion regarding the MP4/M4A file extensions for audio files. Rename the .mp4 (or .m4b) extension to .m4a if you want PAPlayer core to be able to play it, otherwise the MPlayer core will handle playback. Also worth mentioning, PAP does NOT support DRM'd (Apple iTunes store) music files, (these usually have the extension .m4p). Plain .aac files works without issues.
ii. The APE decoder does not like files with the highest compression, they will play, but it can take quite a while to start them, which results that they are no longer gapless.
iii. DTS-CDDA and DTS-WAV files will never be outputted as DTS on an Xbox, this is because it must be resampled by XBMC to 48kHz.
iv. Since there's so many different extensions used, you need to add .adplug to the end of the filename to ease identification for our player.
v. Put configuration file at q:\system\players\paplayer\timidity\timidity.cfg.

Troubleshooting

If you find that a codec unsupported by Mplayer does not play (or even show up in filelist), and you checked that you have the appropriate codec in [XBMCFOLDER]/system/players/paplayer, chances are that you did not update (add new .extension) to the <musicextensions> of advancedsettings.xml.