Mercurial > hg > xmms-sid
annotate README @ 205:de47d797ee33
Updates to contact information.
| author | Matti Hamalainen <ccr@tnsp.org> |
|---|---|
| date | Wed, 15 Dec 2004 10:18:00 +0000 |
| parents | 69de64975d18 |
| children | e9ea4ce4c697 |
| 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 | |
| 204 | 30 produced are harsher and emulation of SID filter is far from |
| 171 | 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 | |
| 204 | 35 OS distributions have pre-built packages of it, not something that |
| 171 | 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 |
|
205
de47d797ee33
Updates to contact information.
Matti Hamalainen <ccr@tnsp.org>
parents:
204
diff
changeset
|
125 IRC : The #xmms-sid on freenode has been TERMINATED, so |
|
de47d797ee33
Updates to contact information.
Matti Hamalainen <ccr@tnsp.org>
parents:
204
diff
changeset
|
126 don't bother going there. After 2 years of idling |
|
de47d797ee33
Updates to contact information.
Matti Hamalainen <ccr@tnsp.org>
parents:
204
diff
changeset
|
127 alone on that channel, I got bored. |
| 204 | 128 |
|
205
de47d797ee33
Updates to contact information.
Matti Hamalainen <ccr@tnsp.org>
parents:
204
diff
changeset
|
129 But I do hang on #xmms at irc.freenode.net by |
|
de47d797ee33
Updates to contact information.
Matti Hamalainen <ccr@tnsp.org>
parents:
204
diff
changeset
|
130 unsurprising nickname "ccr". |
| 204 | 131 (see http://www.freenode.net/ for more information) |
| 1 | 132 |
|
112
fb16fc1fd506
Minor updates to docs, added reference to IRC-channel
Matti Hamalainen <ccr@tnsp.org>
parents:
93
diff
changeset
|
133 E-mail : ccr@tnsp.org |
| 1 | 134 |
|
112
fb16fc1fd506
Minor updates to docs, added reference to IRC-channel
Matti Hamalainen <ccr@tnsp.org>
parents:
93
diff
changeset
|
135 Homepage : http://www.tnsp.org/xmms-sid.php |
| 191 | 136 |