Difference between revisions of "Exaile"

From ArchWiki
Jump to: navigation, search
(Playing audio CDs)
(Added fix for the integrated Last.fm "loved tracks" plugin not working due to lack of python2-pylast on the system.)
(27 intermediate revisions by 14 users not shown)
Line 1: Line 1:
[[Category: Audio/Video (English)]]
+
[[Category:Player]]
=Description=
+
[[es:Exaile]]
[http://www.exaile.org/ Exaile] is a music player written in python that uses the GTK+ toolkit. Exaile is released under the [http://www.gnu.org/copyleft/gpl.html/|GPL] license. Features include:
+
[[it:Exaile]]
*Retrieval of album art, lyrics, artist/album information (via Wikipedia), and guitar tabs (via fretplay.com)
+
[[ru:Exaile]]
*Tabbed playlists
+
[http://www.exaile.org/ Exaile] is a music manager and player for GTK+ written in Python. It incorporates automatic fetching of album art, lyrics fetching, Last.fm scrobbling, support for many portable media players, internet radio such as shoutcast, and tabbed playlists.
*iPod Support
+
*Last.fm support
+
*SHOUTcast directory browser
+
*Track blacklisting
+
  
=Installation=
+
==Installation==
  
Exaile is available in [[Official Repositories|Arch's community repository]]. To enable the community repository, it must be uncommented in /etc/pacman.conf:
+
{{AUR|Exaile}} is available in the [[AUR]].
  
[community]
+
If you use [[ALSA]] and want to use alsasink instead of the default one, [[pacman|install]] {{Pkg|gstreamer0.10-base-plugins}} available in the [[Official Repositories]]. This may solve problem if no sound is heard after installation and also when trying to play several sources simultaneously.
# Add your preferred servers here, they will be used first
+
  Include = /etc/pacman.d/community
+
  
Exaile can then be installed using [[Pacman]]:
+
===Enabling cover art, lyrics, and guitar tablature===
 +
While installing Exaile via Pacman will also install any needed runtime dependencies, two additional packages {{pkg|gnome-python-extras}} & {{Pkg|libgtkhtml}} will be needed to enable the cover art, lyrics, guitar tablature, and wiki features of Exaile.
  
  pacman -Sy exaile
+
  pacman -S gnome-python-extras libgtkhtml
  
=Enabling cover art, lyrics, and guitar tablature=
+
===Playing audio CDs===
While installing Exaile via Pacman will also install any needed runtime dependencies, two additional packages ([http://www.archlinux.org/packages/search/?q=gnome-python-extras gnome-python-extras] & [http://www.archlinux.org/packages/search/?q=libgtkhtml libgtkhtml]) will be needed to enable the cover art, lyrics, guitar tablature, and wiki features of Exaile.
+
Exaile requires 'python-cddb' to play audio cd's. The correct package for this is [https://aur.archlinux.org/packages.php?do_Details=1&ID=3717&O=0&L=0&C=0&K=cddb&SB=n&SO=a&PP=25&do_MyPackages=0&do_Orphans=0&SeB=ndcddb-py/ cddb-py].
  
pacman -Sy gnome-python-extras libgtkhtml
+
==Enabling multimedia keys irrespective of DE/WM==
  
=Problems=
+
First, run {{ic|xev}} and retrieve the keycodes for the Previous, Next, Play, Stop, and Mute keys. Then create a textfile and add lines in the following format: {{ic|keycode 173 = XF86AudioPrev}}. Replace the keycode (173) with your own keycode for the Previous key. Repeat the process for the other keys, substituting 'Prev' for 'Next', 'Play', 'Stop', and 'Mute'.
==Exaile 0.2.9 Album Art==
+
On May 18th, 2007 [http://www.amazon.com Amazon] has updated their ECS API. This update has cause the inability of Exaile <=0.2.9 to retrieve album art. A patch which restores the ability to restore album art retrieval from Amazon has been provided on [http://www.exaile.org/ Exaile's website] along with instructions on how to apply the patch. This issue has already been addressed in Exaile's SVN.
+
  
==Playing audio CDs==
+
Then edit {{ic|~/.xinitrc}} and add the line {{ic|xmodmap <file name>}} prior to the 'exec' command (if there is one) for the DE/WM, where <file name> is the path to the text file created above.
Exaile requires 'python-cddb' to play audio cd's. The correct package for this is [http://aur.archlinux.org/packages.php?do_Details=1&ID=3717&O=0&L=0&C=0&K=cddb&SB=n&SO=a&PP=25&do_MyPackages=0&do_Orphans=0&SeB=ndcddb-py/ cddb-py], located in the AUR. NOT pycddb which is available through pacman. The [http://aur.archlinux.org/packages/cddb-py/cddb-py/PKGBUILD PKGBUILD] needs the line "arch=('i686')" added to build, and the license line is empty, although it doesn't effect the build.
+
 
 +
Finally, in Exaile, go to Edit → Preferences → Plugins, and enable the XKeys plugin. After a restart, multimedia keys should work.
 +
 
 +
==Troubleshooting==
 +
 
 +
===Progress bar stuck at 0:00===
 +
First, make sure there are no problems with your sound architecture ([[ALSA]], [[OSS]], etc.). And your ''playback sink'' in Exaile is set correctly. Try setting it to automatic first.
 +
 
 +
If you're trying to listen to an MP3 file, try playing an audio file encoded in a different format, such as .ogg or .flac. If these play correctly then try installing gstreamer-ugly.
 +
 
 +
pacman -S gstreamer0.10-ugly gstreamer0.10-ugly-plugins
 +
 
 +
==="Playback error encountered! Configured audiosink bin0 is not working"===
 +
If you're getting a message like this, or "Configured audiosink bin1 is not working" (or with another number after 'bin'), it may be because Flash is blocking the use of ALSA by Exaile. You can fix this by running
 +
 
 +
killall npviewer.bin
 +
 
 +
In certain cases (such as if a YouTube video has finished playing), Flash may be blocking the use of ALSA even if an 'npviewer.bin' process is not running. In that case, refreshing the offending page while using a Flash blocking browser extension should fix the problem.
 +
 
 +
===Playing from SMB share===
 +
Unfortunately, Exaile does NOT support smb protocol.
 +
 
 +
==="Last.fm Loved Tracks" plugin not working===
 +
When launched from console, Exaile emits a warning in the command line:
 +
 
 +
WARNING : Error while connecting to Last.fm network: 'module' object has no attribute 'LastFMNetwork'
 +
 
 +
You need to install the [https://aur.archlinux.org/packages/python2-pylast/ python2-pylast package] from AUR.

Revision as of 00:04, 15 February 2013

Exaile is a music manager and player for GTK+ written in Python. It incorporates automatic fetching of album art, lyrics fetching, Last.fm scrobbling, support for many portable media players, internet radio such as shoutcast, and tabbed playlists.

Installation

ExaileAUR is available in the AUR.

If you use ALSA and want to use alsasink instead of the default one, install gstreamer0.10-base-plugins available in the Official Repositories. This may solve problem if no sound is heard after installation and also when trying to play several sources simultaneously.

Enabling cover art, lyrics, and guitar tablature

While installing Exaile via Pacman will also install any needed runtime dependencies, two additional packages gnome-python-extras & libgtkhtml will be needed to enable the cover art, lyrics, guitar tablature, and wiki features of Exaile.

pacman -S gnome-python-extras libgtkhtml

Playing audio CDs

Exaile requires 'python-cddb' to play audio cd's. The correct package for this is cddb-py.

Enabling multimedia keys irrespective of DE/WM

First, run xev and retrieve the keycodes for the Previous, Next, Play, Stop, and Mute keys. Then create a textfile and add lines in the following format: keycode 173 = XF86AudioPrev. Replace the keycode (173) with your own keycode for the Previous key. Repeat the process for the other keys, substituting 'Prev' for 'Next', 'Play', 'Stop', and 'Mute'.

Then edit ~/.xinitrc and add the line xmodmap <file name> prior to the 'exec' command (if there is one) for the DE/WM, where <file name> is the path to the text file created above.

Finally, in Exaile, go to Edit → Preferences → Plugins, and enable the XKeys plugin. After a restart, multimedia keys should work.

Troubleshooting

Progress bar stuck at 0:00

First, make sure there are no problems with your sound architecture (ALSA, OSS, etc.). And your playback sink in Exaile is set correctly. Try setting it to automatic first.

If you're trying to listen to an MP3 file, try playing an audio file encoded in a different format, such as .ogg or .flac. If these play correctly then try installing gstreamer-ugly.

pacman -S gstreamer0.10-ugly gstreamer0.10-ugly-plugins

"Playback error encountered! Configured audiosink bin0 is not working"

If you're getting a message like this, or "Configured audiosink bin1 is not working" (or with another number after 'bin'), it may be because Flash is blocking the use of ALSA by Exaile. You can fix this by running

killall npviewer.bin

In certain cases (such as if a YouTube video has finished playing), Flash may be blocking the use of ALSA even if an 'npviewer.bin' process is not running. In that case, refreshing the offending page while using a Flash blocking browser extension should fix the problem.

Playing from SMB share

Unfortunately, Exaile does NOT support smb protocol.

"Last.fm Loved Tracks" plugin not working

When launched from console, Exaile emits a warning in the command line:

WARNING : Error while connecting to Last.fm network: 'module' object has no attribute 'LastFMNetwork'

You need to install the python2-pylast package from AUR.