head	1.2;
access;
symbols;
locks; strict;
comment	@# @;


1.2
date	2002.02.04.00.55.43;	author mld;	state dead;
branches;
next	1.1;

1.1
date	2002.01.07.12.41.03;	author mld;	state Exp;
branches;
next	;


desc
@@


1.2
log
@*** empty log message ***
@
text
@playuade - a shell script for playing Amiga music files from console
--------------------------------------------------------------------

A shell script for playing one or more Amiga files from console more easily.


Features:
---------
Uade can play single files but is also able to play files with wildcards.
Song changes either when the song ends or user presses <ctrl>+<c>.

If neccessary useful switches like -sub for subsong selection, -ntsc
for NTSC playspeed, and -noend for infinite playing can be used with
playuade too.

Installation:
-------------

There's no extra installation process. Playuade will be "built" and
installed with the uade configure/install process.


Usage:
------

    playuade filename [-switches]


Examples:
	
# Play the Protracker file Knulla kuk!

    playuade mod.knullakuk


# Play the Protracker file Knulla kuk! until user presses <ctrl>+<c>

    playuade mod.knullakuk -noend


# Play all files in directory /mnt/cdrom/sidmon1/
# playuade changes to next file either if the song ends or user
# presses <ctrl>+<c> or <ctrl> + <\>

    playuade /mnt/cdrom/sidmon1/*


# Play the subsong 2 of the custom tune defender of the crown in 60hz
# note: enclose the -sub switch and the subsong number in quotes

    playuade cust.defender_the_crown "-sub 2" -ntsc


# Manually override the replayer that should be used to play
# note: enclose the -P switch and the path to the replayer in quotes

    playuade mdat.R-Type "-P /usr/local/share/uade/deliplayers/TFMX"


# for playuade with either ESD or ARTS use their dsp wrappers:

    ESD:	esddsp playuade DW.BubbleBobble
    ARTS:	artsdsp playuade DW.BubbleBobble


Known Bugs:
-----------

- files having spaces in their filepath and filename are currently not played
- switches like -sub or -M have to be passed with quotes.
  E.g: playuade file1 "-sub 1"
- playuade file1 "-sub 1" file2 "-sub 7" will play subsong 7 for
  both file1 and file2...

Compatibility:
--------------
playuade was tested on Linux, Solaris and FreeBSD 4.4


Credits:
--------
- the idea and the name "playuade" is based on an experimental c program
  by Bastian Spiegel, which had the same purpose.
- playuade was implemented and tested by Heikki Orsila, Michael Doering,
  Xigh, Asle and Meleth
@


1.1
log
@*** empty log message ***
@
text
@@

