File	Date	Author	Commit
src	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
AUTHORS	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
COPYING	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
ChangeLog	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
INSTALL	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
Makefile.am	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
Makefile.in	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
NEWS	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
README	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
TODO	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
acinclude.m4	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
aclocal.m4	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
configure	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
configure.in	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
install-sh	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
missing	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
mkinstalldirs	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS
psid64.spec.in	2001-09-08	Roland Hermans	[ae5db3] initial import into CVS

Read Me

                                 PSID64 README
                                 =============

INTRODUCTION
------------

PSID64 is a program that automatically generates a C64 self extracting
executable from a PSID file. The executable contains the PSID data, a
pre-relocated player and may also - if there is enough space available in the
C64 environment - contain a demonstration program with information about the
PSID file.

PSID files contain music code and data originally generated on the Commodore 64
(C64). If you're new to PSID files please refer to the introduction chapter of
the High Voltage SID Collection documentation for a brief introduction into SID
music.

Before PSID64, playing PSID files on a C64 or a C64 emulator has been a rather
frustrating experience. The fundamental problem of where to locate the PSID
driver has simply not been appropriately addressed. Actually, having a PSID
file play at all has been pure luck, since there has been made no attempt to
find a memory range that is not written to by the music code. Not surprisingly,
a large number of PSID files could not be played at all using existing C64
computers and C64 emulator SID players.

The document "Proposal for C64 compatible PSID files", written by Dag Lem and
Simon White extends the PSID format with relocation information. PSID64 is the
first implementation of a PSID player intended for playback on a real C64 or
C64 environment that uses this relocation information stored in the PSID
header.


USAGE
-----

PSID64 is invoked from the command line as follows:

    psid64 <psid_file> <c64_file>

where <psid_file> is the name of the PSID file and <c64_file> the name of the
resulting C64 executable.


KEYS PLAYER INSTRUCTIONS
------------------------

1-0, A-Z		Select tune 1-36
RUN/STOP		Stop playback
LEFT ARROW		Fast forward (*)
SHIFT LEFT / LOCK	Show rastertime used by player (*)
CONTROL + CBM + DEL	Reset computer

* not available for custom players (i.e. play address is $0000).


OTHER TOOLS
-----------

Andre Fachat's relocating 6502 cross assembler XA is used to create the
relocatable driver code. XA can be found at:

    http://www.tu-chemnitz.de/~fachat/c64/xa/index.html

The C64 executables produced by PSID64 can be compressed with pucrunch, the
freeware cross-cruncher developed by Pasi 'Albert' Ojala. Pucrunch can be
downloaded from:

    http://www.cs.tut.fi/~albert/Dev/pucrunch/