Mercurial > hg > xmms-sid
annotate README @ 200:ec8b735f5418
Support for libNanoSID dropped.
author | Matti Hamalainen <ccr@tnsp.org> |
---|---|
date | Thu, 19 Aug 2004 19:06:02 +0000 |
parents | 6117c326cc3e |
children | 69de64975d18 |
rev | line source |
---|---|
7 | 1 XMMS-SID - SIDPlay input plugin for X MultiMedia System (XMMS) |
1 | 2 ============================================================== |
162
d3425d53be3a
Updated documentation, upgraded libtool to 1.5.6 which should fix problems
Matti Hamalainen <ccr@tnsp.org>
parents:
160
diff
changeset
|
3 Programmed and designed by Matti 'ccr' Hamalainen |
d3425d53be3a
Updated documentation, upgraded libtool to 1.5.6 which should fix problems
Matti Hamalainen <ccr@tnsp.org>
parents:
160
diff
changeset
|
4 (C) Copyright 1999-2004 Tecnic Software productions (TNSP) |
1 | 5 |
7 | 6 MD5 Algorithm code for song-length database handling |
7 by L. Peter Deutsch <ghost@aladdin.com> | |
8 (C) Copyright 1999 Aladdin Enterprises. All rights reserved. | |
1 | 9 |
10 | |
146
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
11 Short Introduction |
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
12 ================== |
7 | 13 XMMS-SID is a plugin for XMMS (X MultiMedia System) which provides |
146
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
14 support for playing Commodore 64 "SID tunes", which are music |
199 | 15 from old Commodore computer software including games, demos, etc. |
1 | 16 |
146
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
17 |
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
18 |
171 | 19 Installation requirements and recommendations |
20 ============================================= | |
21 Refer to file "INSTALL" for information about what XMMS-SID requires, | |
146
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
22 where to get those required packages and how to install. |
1 | 23 |
199 | 24 Some words on which emulation library you should choose to install |
25 and use - it depends somewhat on your system and personal preferences. | |
171 | 26 |
27 | |
28 - libSIDPlay v1: This is the old SIDPlay v1 emulation library. Its | |
29 emulation is "frame-based" and not very accurate. The waveforms | |
30 produced are harsher and emulation if SID filter is far from | |
31 accurate. | |
32 | |
33 libSIDPlay v1 requires very little CPU power, it is faster and | |
34 may have fewer bugs due to being more mature software. Many | |
35 distributions have pre-built packages of it, not something that | |
36 can be said of libSIDPlay v2. Some people may even like the | |
37 harsher sound produced by libSIDPlay v1. | |
38 | |
39 Drawbacks are: worse emulation, eventually weakening compability | |
40 as new SID-tunes/files are ripped into "RSID"-format which | |
41 libSIDPlay v1 does NOT support. | |
42 | |
43 | |
44 - libSIDPlay v2: New, next generation modular SID-emulation framework. | |
45 Along with reSID-library it produces probably most accurate emulated | |
46 representation of SID-chip available. This, however, comes at high | |
47 cost: libSIDPlay2 tends to eat CPU like popcorn, depending on the | |
48 selected emulation options. It is also less spread, not as many | |
49 distributions/operating systems come with pre-packaged libSIDPlay2, | |
50 so you may have to roll your own. | |
51 | |
52 Also the API-stability of libSIDPlay2 is not yet 100%, there may | |
53 be changes. Bugs are evident, though many of them will be fixed | |
54 eventually. | |
55 | |
56 | |
57 Conclusion thus is as follows: If you are using an old system with not | |
193 | 58 much spare CPU-power, choose libSIDPlay v1. On a relatively recent |
59 system (more powerful than Pentium III 500MHz) you may wish to choose | |
60 libSIDPlay v2, although your mileage may vary. | |
171 | 61 |
200
ec8b735f5418
Support for libNanoSID dropped.
Matti Hamalainen <ccr@tnsp.org>
parents:
199
diff
changeset
|
62 |
ec8b735f5418
Support for libNanoSID dropped.
Matti Hamalainen <ccr@tnsp.org>
parents:
199
diff
changeset
|
63 |
ec8b735f5418
Support for libNanoSID dropped.
Matti Hamalainen <ccr@tnsp.org>
parents:
199
diff
changeset
|
64 Configuration |
ec8b735f5418
Support for libNanoSID dropped.
Matti Hamalainen <ccr@tnsp.org>
parents:
199
diff
changeset
|
65 ============= |
ec8b735f5418
Support for libNanoSID dropped.
Matti Hamalainen <ccr@tnsp.org>
parents:
199
diff
changeset
|
66 |
171 | 67 |
1 | 68 |
69 Usage | |
70 ===== | |
7 | 71 Using the plugin is quite simple: if you are familiar with XMMS and |
72 SIDPlay, then you already know how to use XMMS-SID. Configuration | |
146
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
73 should be self-explanatory for most part, here are few tips: |
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
74 |
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
75 * XSIDPLAY-compatible song-length database is a file that contains |
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
76 lengths for most songs in High Voltage SID Collection (HVSC). I |
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
77 highly recommend that you download the database and configure |
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
78 XMMS-SID to use it. The SLDB is available at |
d9d776c6f4cd
Added information about SLDB, cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents:
134
diff
changeset
|
79 http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/sldb.html |
7 | 80 |
193 | 81 * SIDPlay2-emulation is heavier, but more accurate. So you need to |
82 have more CPU-power for it. | |
1 | 83 |
7 | 84 * Oversampling is available with SIDPlay2-emulation, it can further |
55 | 85 enchange the audio quality, but you need some really powerful |
86 hardware to run it smoothly. | |
1 | 87 |
7 | 88 * Filter-settings can be usually left as they are, unless you know |
89 what you're doing. | |
1 | 90 |
7 | 91 * If the plugin doesn't recognize your SID-tunes, try checking the |
193 | 92 'Determine filetype by contents' option in the XMMS-SID config |
93 window. This is horrendously slow if you're reading a 10000-tune | |
94 playlist, though. | |
1 | 95 |
193 | 96 * For those who don't know it: Autopanning and stereo are not native |
97 to the original SID chip, but are extra options implemented in | |
98 libSIDPlay. So if you think that the tune does not sound as it | |
99 sounds on real C64, use the Mono setting. | |
1 | 100 |
101 * The "kb/s rate" box is actually the play rate in Hz, so you can | |
102 see if it's an NTSC or PAL song (if you haven't set the Force Speed | |
103 option). | |
104 | |
7 | 105 Also see FAQ for more tips, notes and such. |
106 | |
1 | 107 |
158 | 108 License |
109 ======= | |
110 XMMS-SID is distributed under GNU General Public License version 2, | |
111 see COPYING for more information. | |
112 | |
113 If you like XMMS-SID, you can thank me by distributing message | |
114 about it's existence and voting it on freshmeat.net. | |
115 | |
116 | |
117 Contact, support and new versions | |
118 ================================= | |
7 | 119 New releases of this plugin should be available at TNSP's WWW- |
120 homepages, see below for address. Bug-reports, suggestions, | |
158 | 121 patches, etc. should be sent to ccr at least for now, please see |
122 the homepage for latest information. | |
1 | 123 |
191 | 124 |
160
450fea61cad5
Updated IRC-channel information.
Matti Hamalainen <ccr@tnsp.org>
parents:
158
diff
changeset
|
125 IRC : The #xmms-sid on freenode has been TERMINATED. |
191 | 126 But I do idle on #xmms at irc.freenode.net |
127 (see http://www.freenode.net/) | |
1 | 128 |
112
fb16fc1fd506
Minor updates to docs, added reference to IRC-channel
Matti Hamalainen <ccr@tnsp.org>
parents:
93
diff
changeset
|
129 E-mail : ccr@tnsp.org |
1 | 130 |
112
fb16fc1fd506
Minor updates to docs, added reference to IRC-channel
Matti Hamalainen <ccr@tnsp.org>
parents:
93
diff
changeset
|
131 Homepage : http://www.tnsp.org/xmms-sid.php |
191 | 132 |