dockapps/AlsaMixer.app
Andreas Metzler 9881dba989 Clarify project copyright and license, use SPDX
Changes/additions in AlsaMixer.app over Mixer.app were lacking a
copyright information and and license specifications. Add the missing
bits, using a SPDX-License-Identifier.

Documentation for the change follows.
---------------------------------------------------

From petr.hlavka@avast.com Wed May  2 10:57:44 2018
Delivery-date: Wed, 02 May 2018 08:57:44 +0000
Received: from muffat.debian.org ([209.87.16.33])
	by vsrv21575.customer.vlinux.de with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.91)
	(envelope-from <petr.hlavka@avast.com>)
	id 1fDna2-0005LT-O4
	for ametzler@bebt.de; Wed, 02 May 2018 08:57:44 +0000
Received: from mail-qk0-x235.google.com ([2607:f8b0:400d:c09::235])
	by muffat.debian.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
	(Exim 4.89)
	(envelope-from <petr.hlavka@avast.com>)
	id 1fDna0-0001VT-VK
	for ametzler@bebt.de; Wed, 02 May 2018 08:57:41 +0000
Received: by mail-qk0-x235.google.com with SMTP id c70so10628010qkg.0
        for <ametzler@debian.org>; Wed, 02 May 2018 01:57:39 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=avast.com; s=google;
        h=mime-version:in-reply-to:references:from:date:message-id:subject:to;
        bh=todeyYOMQgF5NFi+g8Ch3ff7DLqVyjdpO1jnkiSCnwQ=;
        b=dTOhJ1+p5j29A0wiZExWtmDgNHdAYz4TBYldVuTScFHsdG2sEnQQJ0jhLcdJBZWtB/
         f9zbg70xN2O++EiXmWzHO///LWZQVvmqxRfWe9e9NinQiftLvebLt0qhNDqGurm0XGuR
         ElxIv7xaik7A76zuy4RiWLBQPJImsdbkj8w8o=
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20161025;
        h=x-gm-message-state:mime-version:in-reply-to:references:from:date
         :message-id:subject:to;
        bh=todeyYOMQgF5NFi+g8Ch3ff7DLqVyjdpO1jnkiSCnwQ=;
        b=QruIZh5tAR6Ob3A5x4497372oBuHE3qBVI4pMDCb11By/sgVj7VWrzFcEzBKa+sZak
         J5y4nddBXL7usk4ULNYROXWym6dbjgcqqCX7nEdIQvze9FW7+bM/JMR+a69dxP2MFmVr
         v2P9F0xCyiU8MLXlvMQqgwmTPuyNAQgHledmWGWFzBjbKgJb7LDwM7Hs3aU7fTyRJm+1
         Ue4obJVABrLq398pXAlqupNDMb4F4Ss6/HcBxKhFKugxv5dRNCJFB0VPWl+/L/8qA6Dm
         1rUSVtcpoLdD1Tv+wZY9+rnzR4WVj/u/0JPhWIiH4UK4oeq0cLLEiUlVx3z5ZW4/xnlb
         cmmw==
X-Gm-Message-State: ALQs6tCW+VHY1vjrOxqi926/NtpVquOr/uyKzag66grdOQjv2d3QOHcx
	ITgzzFb/gW/K1WQYcwUDIpKXhav0rQUGhXagXfLCYjezYz8=
X-Google-Smtp-Source: AB8JxZrk2YDpWABvmBchDvRP6pMGHcJOS47obZEdkq/pZa72T3z10UOShV65Z5FzTjgF7CmqxSk2hmMpKTIzLbef3mA=
X-Received: by 10.55.120.68 with SMTP id t65mr15084912qkc.56.1525251456867;
 Wed, 02 May 2018 01:57:36 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.12.152.219 with HTTP; Wed, 2 May 2018 01:57:36 -0700 (PDT)
In-Reply-To: <20180430125042.GA1331@argenau.bebt.de>
References: <20180430125042.GA1331@argenau.bebt.de>
From: =?UTF-8?Q?Hl=C3=A1vka=2C_Petr?= <petr.hlavka@avast.com>
Date: Wed, 2 May 2018 10:57:36 +0200
Message-ID: <CACiAdzoA3hsfNG_5Xm-2wYJyZaEYH=xhK=8BrUq5YWVZRYncDg@mail.gmail.com>
Subject: Re: AlsaMixer.app - license?
To: Andreas Metzler <ametzler@debian.org>
Content-Type: multipart/alternative; boundary="94eb2c0a95da487efd056b354749"
Status: RO
X-Status: A
Content-Length: 3528

--94eb2c0a95da487efd056b354749
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Hello Andreas,

yes, I'm the author of modification to original Mixer.app (AlsaMixer.app).
They should be licensed under the same license as Mixer.app, some info is
available in
http://repo.or.cz/dockapps.git/blob_plain/HEAD:/AlsaMixer.app/README ,
section Copyright.

  Regards, Petr Hlavka.

On Mon, Apr 30, 2018 at 2:50 PM, Andreas Metzler <ametzler@debian.org>
wrote:

> Dear Mr Hl=C3=A1vka,
>
> I guess that you are the original author of AlsaMixer.app
> <https://www.dockapps.net/alsamixerapp>. If that is not case I am
> sorry for bothering you unnecessaly but would appreciate if you told
> me. - Thanks in advance
>
> On the other hand if you are the author it would be helpful if you could
> clarify the question of licensing. AlsaMixer.app is based on Mixer.app
> which is licensed under GNU General Public License version 2 or later.
> The modifications and additions for AlsaMixer.app only a carry a
> copyright info but no licensing info:
>
> Copyright
> --------------------------------------------------------------
> AlsaMixer.app, 2004, Petr Hlavka
> [...]
> // AChannel.cc, Petr Hlavka, 2004
>
> I guess that your contributions are also available under GPL v2 or
> later. Could you confirm this?
>
> Thanks in advance, kind Regards
>
> Andreas Metzler
>

--94eb2c0a95da487efd056b354749
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">Hello Andreas,<div><br></div><div>yes, I&#39;m the author =
of modification to original Mixer.app (AlsaMixer.app). They should be licen=
sed under the same license as Mixer.app, some info is available in=C2=A0<a =
href=3D"http://repo.or.cz/dockapps.git/blob_plain/HEAD:/AlsaMixer.app/READM=
E">http://repo.or.cz/dockapps.git/blob_plain/HEAD:/AlsaMixer.app/README</a>=
 , section Copyright.</div><div><br></div><div>=C2=A0 Regards, Petr Hlavka.=
</div></div><div class=3D"gmail_extra"><br><div class=3D"gmail_quote">On Mo=
n, Apr 30, 2018 at 2:50 PM, Andreas Metzler <span dir=3D"ltr">&lt;<a href=
=3D"mailto:ametzler@debian.org" target=3D"_blank">ametzler@debian.org</a>&g=
t;</span> wrote:<br><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0=
 .8ex;border-left:1px #ccc solid;padding-left:1ex">Dear Mr Hl=C3=A1vka,<br>
<br>
I guess that you are the original author of AlsaMixer.app<br>
&lt;<a href=3D"https://www.dockapps.net/alsamixerapp" rel=3D"noreferrer" ta=
rget=3D"_blank">https://www.dockapps.net/<wbr>alsamixerapp</a>&gt;. If that=
 is not case I am <br>
sorry for bothering you unnecessaly but would appreciate if you told<br>
me. - Thanks in advance<br>
<br>
On the other hand if you are the author it would be helpful if you could<br=
>
clarify the question of licensing. AlsaMixer.app is based on Mixer.app<br>
which is licensed under GNU General Public License version 2 or later.<br>
The modifications and additions for AlsaMixer.app only a carry a<br>
copyright info but no licensing info:<br>
<br>
Copyright<br>
------------------------------<wbr>------------------------------<wbr>--<br=
>
AlsaMixer.app, 2004, Petr Hlavka<br>
[...]<br>
// AChannel.cc, Petr Hlavka, 2004<br>
<br>
I guess that your contributions are also available under GPL v2 or<br>
later. Could you confirm this?<br>
<br>
Thanks in advance, kind Regards<br>
<span class=3D"HOEnZb"><font color=3D"#888888"><br>
Andreas Metzler<br>
</font></span></blockquote></div><br></div>
2018-05-10 19:28:12 +01:00
..
AMixer Clarify project copyright and license, use SPDX 2018-05-10 19:28:12 +01:00
olddoc Clarify project copyright and license, use SPDX 2018-05-10 19:28:12 +01:00
skins Add AlsaMixer.app to repository 2012-10-02 23:26:31 +01:00
AlsaMixer.app.spec Add AlsaMixer.app to repository 2012-10-02 23:26:31 +01:00
COPYING Clarify project copyright and license, use SPDX 2018-05-10 19:28:12 +01:00
INSTALL Add AlsaMixer.app to repository 2012-10-02 23:26:31 +01:00
Main.cc Clarify project copyright and license, use SPDX 2018-05-10 19:28:12 +01:00
Makefile Clarify project copyright and license, use SPDX 2018-05-10 19:28:12 +01:00
Mixer.cc Clarify project copyright and license, use SPDX 2018-05-10 19:28:12 +01:00
Mixer.h Clarify project copyright and license, use SPDX 2018-05-10 19:28:12 +01:00
README Remove trailing whitespace. 2014-10-05 19:18:49 +01:00
Xpm.cc Remove trailing whitespace. 2014-10-05 19:18:49 +01:00
Xpm.h Remove trailing whitespace. 2014-10-05 19:18:49 +01:00
pixmaps Add AlsaMixer.app to repository 2012-10-02 23:26:31 +01:00

README

Description
--------------------------------------------------------------
AlsaMixer.app is a mixer utility for Linux systems with ALSA sound driver.
It is designed to be docked in Window Maker (and other wms). This utility has
three volume controllers that can be configured to handle any sound source,
he default sources are 'Master', 'PCM' and 'CD' volume. Sound sources can be
easily muted and there is also wheel mouse support.
The whole GUI and command parsing was taken from Mixer.app (see old doc
for URL's), only connection to ALSA driver was added.


Hints
--------------------------------------------------------------
Error led:
	If the led on Mixer.app is red an error message has
	been printed to stderr and something is not working
	correctly. If the led is green everything is working ok.
	(Error led doesn't work in AlsaMixer.app, TODO)

Mute:
	Right click on a volume controller to mute the sound
	source. The button will then have a red led in one corner.
	Right click again to restore the volume. If a muted sound
	source is modified by another application Mixer.app will
	automaticaly release its muted state.

Wheel mouse:
	If you have a wheel mouse (where the wheel is configured as
	Button4 and Button5) you can control the volume by just moving
	the mouse over Mixer.app and roll the wheel up and down. Use
	the command line option -w to specify which slider that should
	react to the wheel movement.

Label:
	If you run multiple instances of AlsaMixer.app you might want
	to be able to tell them apart. This can easily be done
	by setting a label to each one of them. By using the -l
	option you can add a little text label at the bottom of
	the mixer.

Save volume settings:
	Use the option -S (and -f <file>) if you want the volume
	settings to be saved when AlsaMixer.app exits, and then
	-L to be loaded again when AlsaMixer.app is started the next time.
	When not using -f the settings are saved in/loaded from
	~/GNUstep/Defaults/AlsaMixer. Use the -f <file> option
	if you want to use a different file.
	(TODO: mute states aren't saved/loaded)

Configurable middle click:
	By default, when you middle click anywhere inside application
	window, app tries to load default mixer setting from default
	or explicitly configured (-f) file. If file doesn't exist,
	nothing happens.
	You can also configure AlsaMixer.app to run command (i.e.
	better mixer) on middle click by using -e <command> option.

Bugs
--------------------------------------------------------------
If you discover any bugs in this software, please send a
bugreport to xhlavk00@stud.fit.vutbr.cz and describe the problem.


Special thanks to
--------------------------------------------------------------
Per Liden <per@fukt.bth.se> - original author of Mixer.app
David Sauer <davids@iol.cz>
Theo Schlossnagle <theo@omniti.com>
Alban Hertroys <dalroi@wit401310.student.utwente.nl>


Copyright
--------------------------------------------------------------
AlsaMixer.app, 2004, Petr Hlavka
Mixer.app is copyright (c) 1998-2002 by Per Liden and is
licensed through the GNU General Public License. Read the
COPYING file for the complete license.

Minor parts of this code were taken from asmixer by Rob Malda
(malda@slashdot.org)