Mercurial > hg > xmms-sid
annotate INSTALL @ 210:5648f2ca3eb2
Updated requirements
author | Matti Hamalainen <ccr@tnsp.org> |
---|---|
date | Wed, 15 Dec 2004 10:26:00 +0000 |
parents | ec8b735f5418 |
children | b02705a9b2d6 |
rev | line source |
---|---|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
1 This document describes overall requirements and procedure |
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
2 for installation of XMMS-SID package, please read it carefully! |
171 | 3 For more tips, please also read README and FAQ. |
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
4 |
1 | 5 Requirements |
6 ============ | |
7 - XMMS version 1.2.0 or later (http://www.xmms.org/) | |
7 | 8 |
145 | 9 - Gtk+ and Glib 1.2.5 or later (http://www.gtk.org/) |
7 | 10 |
171 | 11 - C and C++-compiler. Preferably GCC along with rest of the |
12 GNU toolchain. I have no idea whether this compiles with | |
13 any other compiler ... sorry. | |
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
14 |
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
15 - You need AT LEAST one emulation library: |
7 | 16 |
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
17 * libSIDPlay1 |
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
18 * libSIDPlay2 |
7 | 19 |
171 | 20 Only one is required, but all are supported. You may also need |
21 some supplementary libraries, that are required by the emulator | |
22 library. See below for more information. | |
23 | |
24 | |
25 NOTICE! Refer to file README for recommendations about which | |
26 emulator libraries you should install! | |
27 | |
1 | 28 |
29 | |
30 Where to get XMMS? | |
31 ================== | |
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
32 Latest version of XMMS should be available from: |
1 | 33 |
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
34 http://www.xmms.org/ |
1 | 35 |
171 | 36 Please refer to XMMS documentation for information on its usage |
37 and installation, etc. You probably have XMMS already installed, | |
38 but if you installed from a pre-built package, make sure that | |
39 you have corresponding xmms-devel -package also. | |
1 | 40 |
41 | |
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
42 Where to get libSIDPlay1? |
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
43 ========================= |
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
44 libSIDPlay1 is available at SIDPlay's homepage: |
1 | 45 |
145 | 46 http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/linux.html |
1 | 47 |
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
48 You only need libsidplay, the sidplay-base is not necessary |
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
49 if you are sure that you don't need the commandline player. |
1 | 50 |
23 | 51 |
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
52 Where to get libSIDPlay2? |
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
53 ========================= |
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
54 libSIDPlay2 is available at SourceForge: |
7 | 55 |
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
56 http://sidplay2.sourceforge.net/ |
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
57 |
171 | 58 You need the "sidplay-libs-2.1.0" package! Earlier versions WILL NOT |
59 WORK! Later versions MAY work, but I can't really guarantee that. | |
7 | 60 |
80
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
61 |
36 | 62 Building a CVS-version |
63 ====================== | |
64 To build a CVS-version of XMMS-SID, you need to have latest | |
41 | 65 (STABLE) versions of following tools installed, including: |
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
66 |
171 | 67 - GNU autoconf 2.56 or newer |
68 - GNU automake 1.7 (older and newer versions MAY be incompatible!) | |
210 | 69 - GNU libtool 1.5.6 or newer |
41 | 70 - Glade for Gtk+ 1.2 programs (I use Glade 0.6.4) |
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
71 |
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
72 If you have all required tools installed, just run the |
171 | 73 "bootstrap.sh"-script which generates all necessary build-files. |
74 After successfull bootstrapping, you should be able to install | |
75 the package normally, following steps described in next chapter. | |
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
76 |
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
77 |
7 | 78 Installing XMMS-SID |
1 | 79 =================== |
171 | 80 When you have the requirements installed and working succesfully, |
81 you may try compiling and installation of XMMS-SID. | |
7 | 82 |
171 | 83 Invoke configure script (use parameter --help for help) |
7 | 84 |
85 $ ./configure | |
1 | 86 |
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
87 The configure-script will print out lots of information and in |
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
88 the end it tells you some of the selected build options. |
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
89 |
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
90 If configure passed without errors, try compilation. (Depending |
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
91 on your system, you may need to invoke 'gmake' instead of 'make'.) |
1 | 92 |
7 | 93 $ make |
94 | |
198 | 95 If that went OK too, then you may try installation. Again, you |
96 may need to invoke 'gmake' instead of 'make'. Install globally | |
97 to whole system (as root): | |
7 | 98 |
99 # make install | |
1 | 100 |
198 | 101 or install for current user only: |
181
be1cf864f28e
Added install-user and uninstall-user targets which install to current
Matti Hamalainen <ccr@tnsp.org>
parents:
171
diff
changeset
|
102 |
be1cf864f28e
Added install-user and uninstall-user targets which install to current
Matti Hamalainen <ccr@tnsp.org>
parents:
171
diff
changeset
|
103 $ make install-user |
be1cf864f28e
Added install-user and uninstall-user targets which install to current
Matti Hamalainen <ccr@tnsp.org>
parents:
171
diff
changeset
|
104 |
199 | 105 Assuming all went correctly, XMMS-SID should now be installed. |
106 You should now start or re-start XMMS and configure XMMS-SID's | |
107 various options. | |
108 | |
109 | |
110 Post-installation configuration | |
111 =============================== | |
112 To gain full advantages of using XMMS-SID, you need to configure it. | |
113 XMMS-SID can be configured just like any other XMMS plugin, in XMMS | |
114 do as follows: | |
115 | |
116 -> Press <ctrl+p> | |
117 -> Select "Audio I/O Plugins"-tab | |
118 -> Choose "XMMS-SID x.y.z [libxmmssid.so]" from the list | |
119 -> Click "Configure" | |
120 | |
121 Please refer to README for more information about configuration. | |
122 |