INSTALL 7.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259
  1. Install Guide for Plait v 1.6.2
  2. ===============================
  3. 1. Installation
  4. ----------------
  5. Since Plait is glue ware, it has several dependencies. Follow these
  6. instructions to make it all work.
  7. ### Uninstallation
  8. As of Plait 1.5.2, it is possible to install Plait to a directory of
  9. your choice. Since this could lead to a situation where you have
  10. multiple versions of Plait installed in different directories, it's a
  11. good idea to uninstall any old versions of Plait prior to upgrading.
  12. But if you know you are installing to the same directory as the old
  13. version of Plait, this isn't really necessary.
  14. ### Windows/Cygwin prerequisites
  15. Running Plait on Windows requires that you install Cygwin, the open
  16. source UNIX compatibility layer for Windows. Follow the instructions
  17. at Cygwin.com to download and install Cygwin. Plait also requires two
  18. optional packages, wget and gawk. Be sure to select these packages
  19. when you run Cygwin Setup.
  20. For those who are using Winamp, you may need to install it. Get
  21. Winamp at Winamp.com.
  22. In order to control Winamp, Plait uses a COM object written by John
  23. Adcock. To install it:
  24. * Download gen_com.zip from www.adcock8.freeserve.co.uk/winamp.htm
  25. * Unzip.
  26. * Copy gen_com.dll into the C:\Program Files\Winamp\Plugins directory.
  27. * Restart Winamp. Winamp will detect and install the new plugin.
  28. For those using iTunes, a standard installation of that program should
  29. work without any additional steps, but you need to edit the file
  30. ~/.plait/config to make iTunes your music player. Change the line
  31. that defines PLATFORM to read
  32. PLATFORM=cygwin-itunes
  33. ### OS X prerequisites
  34. Running Plait on OS X requires one package that isn't part of the
  35. default install: wget. You can compile wget from source and install
  36. it yourself, if you know how to do that sort of thing. The easier
  37. option is to install "fink" and have fink install wget for you:
  38. * Download fink from fink.sourceforge.net. Follow the instructions
  39. provided there to install it.
  40. * Now install wget. Type
  41. sudo apt-get install wget
  42. and enter your administrator password when prompted.
  43. (Users of Plait 0.53 and earlier also need to take the following step:
  44. * Install gawk and findutils. Type
  45. sudo apt-get install gawk findutils
  46. Newer versions of Plait don't depend on these packages.)
  47. ### GNU/Linux prerequisites
  48. On GNU/Linux, Plait works with ogg123, mpg123, mpg321, Xmms, Beep
  49. Media Player, or amaroK. If you are using Xmms, xmms-shell is also
  50. required. Installation varies depending on your distro. Be sure to
  51. install the package esound if you want to play via esd.
  52. Xmms, Beep Media Player, or amaroK will be used if they are present.
  53. If not, Plaiter will be used as a front end to any command line
  54. players that are present. Otherwise Plait will work in "list only"
  55. mode unless you configure your own player.
  56. ### Finishing up (all operating systems)
  57. You now have all the prerequisites to run Plait. The last step is
  58. installing Plait itself:
  59. * Untar the package:
  60. tar xvzf plait-x.xx.tar.gz
  61. cd plait
  62. * Tell `plait` to install itself. You may run this command as a
  63. non-root user, in which case Plait will default to installing in
  64. your home directory; you may run it as root, in which case Plait
  65. will default to installing in /usr/local; or you may set the install
  66. directory to anything you like by providing an argument. Examples:
  67. su -c "./plait --install"
  68. or
  69. sudo ./plait --install
  70. or
  71. ./plait --install
  72. or
  73. sudo ./plait --install /usr
  74. If you install Plait as a non-root user, you may have to add ~/bin to
  75. your path.
  76. Plait is now ready to run. The first time you run it, Plait will do
  77. some additional self-installation which involves asking for the
  78. location of your music directory. You only have to do this once.
  79. ### Setting up for XSPF
  80. If you want to use the XSPF web publishing feature, you will need to
  81. install the XSPF Web Music Player
  82. (http://musicplayer.sourceforge.net). Download and unpack the player
  83. from that address and then copy the file xspf_player.swf to
  84. ~/.plait/xspf.
  85. If your music library is located on a web server, you also need to set
  86. the variable BASEURL, for example:
  87. BASEURL=http://www.example.com/mp3/
  88. Otherwise, leave BASEURL set to the empty string.
  89. If your music directory is laid out as Artist/Album/Song, you're all
  90. set. Otherwise, you may need to set the three variables ARTISTIDX,
  91. ALBUMIDX, and SONGIDX in the config file. For Example, if your music
  92. directory is laid out as Artist/Year/Album/Song, set
  93. ARTISTIDX=1
  94. ALBUMIDX=3
  95. SONGIDX=4
  96. If your music directory is laid out as Artist/Artist - Album - Song,
  97. set
  98. LEVELSEP="(/| - )"
  99. ARTISTIDX=1
  100. ALBUMIDX=3
  101. SONGIDX=4
  102. 2. Uninstallation
  103. ------------------
  104. If you installed Plait as root, you must be root to uninstall it;
  105. otherwise you must be the same user as you were during installation.
  106. Type
  107. su -c "plait --uninstall"
  108. or
  109. sudo plait --uninstall
  110. or just
  111. plait --uninstall
  112. to uninstall Plait. See the instructions that came with gen_com if
  113. you want to remove that plugin. To remove wget, gawk or findutils,
  114. follow the package removal technique for Cygwin or Fink, as
  115. appropriate. If you are updating Plait, and you decide to install it
  116. into a different directory this time, uninstall the old version before
  117. installing the new one. Otherwise two versions of Plait will be
  118. installed and you can't be sure which one will run.
  119. 3. Customization
  120. ------------------
  121. There are a few changes you can make to ~/.plait/config to customize
  122. the behavior of Plait.
  123. #### File types
  124. By default Plait looks for files of type mp3, wav, aif, ogg and flac.
  125. You can change this by setting the variable TYPES, for example:
  126. TYPES=".ogg .mp3 .flac"
  127. You may need to run `plait --cache` to rebuild the cache after
  128. changing the file types.
  129. As of Plait 1.2, you are advised to set the variable TYPES once to a
  130. very broad set of file types, and then use target devices to customize
  131. your playlists for different devices. You can either redefine one of
  132. the built-in target devices, or define a new one. For example, to
  133. define a target device that supports the same file types as an iPod,
  134. add the following line to the config file:
  135. ipod="m4a M4A mp3 MP3 wav WAV"
  136. In contrast to the TYPES variable, with devices you don't include the
  137. dot in the file extension, and you must repeat each extension twice,
  138. in upper and lower case. In this list, order is important; thus the
  139. ipod device will prefer mp3 files to wav files.
  140. To use this device to build a playlist, select it on the command line:
  141. plait britney --device ipod
  142. You can also set the default device in the config file:
  143. DEVICE="$ipod"
  144. Important note: if you redefine the default device (hifi), you should
  145. then reassign DEVICE to it in the config file, ie:
  146. hifi="wav WAV flac FLAC"
  147. DEVICE="$hifi"
  148. Otherwise DEVICE will continue to have the old value of hifi from
  149. before it was redefined.
  150. #### Alternate players
  151. Although there is a default player on each operating system, some OSs
  152. support several players. You can pick something besides the default
  153. by setting the variable PLATFORM, for example:
  154. PLATFORM=linux-plaiter
  155. The currently supported platforms are: cygwin-winamp, cygwin-itunes,
  156. osx-itunes, linux-xmms, linux-beep-media-player, linux-amarok,
  157. linux-mpg123, linux-mpg123-esd, linux-mpg321, linux-mpg321-esd,
  158. linux-ogg123, linux-ogg123-esd, linux-plaiter, any-xspf and
  159. any-xspf-copy. In the interest of accuracy, there are also "unix-"
  160. synonyms for all the "linux-" players. The "esd" platforms play via
  161. the Enlightened Sound Daemon, which can stream audio across the
  162. network to an esd server. You specify which server by setting
  163. ESPEAKER, for example:
  164. ESPEAKER=192.168.1.2:16001
  165. See README.plaiter for information on Plaiter, which is the ideal
  166. platform choice if you currently use a command line player like
  167. mpg123.
  168. Copyright (c) 2005, 2006 by Stephen Jungels