1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151
|
README for
GOM (Gom is nOt yet another Mixer), a generic audio mixer.
Release 0.30 and prereleases.
Prereleases are versioned "0.29.x", with x being a non-negative integer.
ADMINISTRATIVE
--------------
Map of administrative files:
- README : overall/meta/misc information (this file)
- AUTHORS : list of all copyright holders on the package, or parts of the package
- COPYING : software licence for (this release of) gom
- INSTALL : GNU automake/autoconf generic installation descriptions
- NEWS : list of prominent changes between releases of gom
- ChangeLog: detailed list of changes between releases of gom
(THIS RELEASE OF) GOM MAY ONLY BE DISTRIBUTED, COPIED OR MODIFIED UNDER THE TERMS
OF THE LICENSE FOUND IN THE FILE NAMED "COPYING" INCLUDED IN THIS DISTRIBUTION.
ABSTRACT
--------
gom is a generic audio mixer program; it tries to provide a complete
and convenient interface for all kind of audio mixer manipulation.
gom's facilities include sound driver (compile time) and sound card
(run time) independence, arbitrary mixer selection, loading and saving
of mixer settings, volume fading, verbosity-level driven output,
"Un*x-like scripting support", etc.
At the moment, gom only supports the Open Sound System (OSS) sound
driver. OSS comes with the Linux kernel as free software called
OSS/Free, and is available for a number of other platforms.
Apart from the exhaustive command line interface described here, gom
optionally has two built-in interactive interfaces (that I call
gomiis, gom interactive interfaces;): a terminal gomii using ncurses,
and a X gomii using the xview toolkit. All gomiis support adjustable
(this includes disabling) real time updating.
INSTALLATION
------------
Building and installing is being done by GNU automake/autoconf. Please
refer to the file "INSTALL" for generic installation descriptions, and
to the (special) notes produced by the ./configure script. Basically,
it checks for _some_ possible irregularities (i.e. those that I know
of) , but surely not all, so that a correct check does not necessarily
mean that compilation will succeed on your system.
However, to sum it up, it should be as simple as ($ == user account, #
== administrative account shell prompt):
$ ./configure [options]
$ make
# [make install]
DOCUMENTATION
-------------
* The manual page "gom.1" is the authoritative documentation source
(e.g., "groff -man -Tascii gom.1 | less" views it without installing)
* "gom -h" == "gom --help" or
"gom -H" == "gom --help-verbose" gom's "online" help on options
(completely included in the manual page, too, of course)
REQUIREMENTS, COMPATABILITY
---------------------------
(This section is out of date and may be inaccurate ;)
Mandatory:
* a Un*x system (whatever that is) with one of the following
sound drivers installed:
- Open Sound System (OSS) (all version claiming to instanciate the
OSS API should work).
The Linux kernel includes OSS/Free, so this should work on all
Linux-based Un*x distributions.
Optional:
* a soundcard with mixer (this means that you can actually use gom...)
* ncurses (for the terminal gomii),
* xview toolkit (for the x gomii)
Well...:
At least, that's the theory. The only configurations successfully
tested by me are:
* ix86-Linux with kernel 2.0.x, and OSS/Free 3.5.4.
* ix86-Linux with kernel 2.1.5+, OSS/Free 3.7-beta (note: Hannu calls it
"OSS Lite" in the Readme, neither "OSS/Free" nor "USS Lite", but I will
stick to OSS/Free ;).
Other configurations or other configurations of the above configurations
might (and we all know: most likely will) fail to compile for whatever
unexpected reason.
Specials on the OSS driver:
Any improvements in the driver (e.g. if the new SB16 driver now
supports "mix") will of course directly affect gom; there should be no
need to update/recompile gom if you install a kernel with the new
driver. (Well, ok, for the purist: If the OSS API increases the amount
of possible channels (check SOUND_MIXER_NRDEVICES > 17 in soundcard.h)
-- which seems unlikely --, gom will support these (new channels) only
after recompilation with the new header file.) However, if unsure,
recompile.
UPDATES
-------
Currently, http://www.fh-worms.de/~suerken/gom.html is the WWW-Home
of gom (and the place to find the newest versions).
Additionally, new versions are uploaded sunsite.unc.edu quite
frequently (should be found in the Linux section in
apps/sound/mixers).
If you have a trusted public pgp key of me, and there is a so called
"detached certification" (a seperate pgp signature for a binary file)
accompanying the archive, you can check its integrity with pgp. The
file (if present) is named "<archive_file_name>.sig".
THANKS TO
---------
* Hannu Savolainen (for OSS/Free, his informative OSS programmer's guide
and a good template for my X gomii (xvmixer))
AUTHOR
------
--Stephan Worms, 1997 Sep 23
Wed, 22 Apr 1998 19:39:52 +0200, Debian package change, new
.signature:
o-----------------------------------------------------------------o
| Stephan Alexander Suerken <absurd@debian.org> |
+-----------------------------------------------------------------+
| Voice : (+49) (6241) 92566-2 | Use |
| 2nd Mail: suerken@fh-worms.de | Debian GNU/Linux |
| WWW : http://www.fh-worms.de/~suerken | www.debian.org |
o-----------------------------------------------------------------o
|