Switch to unified view

a/doc/upmpdcli-manual.txt b/doc/upmpdcli-manual.txt
...
...
641
unknown. When feature is active, it actually prevents Lumin from
641
unknown. When feature is active, it actually prevents Lumin from
642
discovering upmpdcli at all, so there is a configuration variable to
642
discovering upmpdcli at all, so there is a configuration variable to
643
disable it: '+lumincompat+'. Set to 1 to use upmpdcli v1.3.0 with Lumin.
643
disable it: '+lumincompat+'. Set to 1 to use upmpdcli v1.3.0 with Lumin.
644
644
645
Upmpdcli uses the *openssl* command to perform the cryptography work. This
645
Upmpdcli uses the *openssl* command to perform the cryptography work. This
646
was not made a hard dependancy, so you should check that it is installed.
646
was not made a hard dependancy, so you should check that it is
647
installed. Unfortunately, I was only able to make things work with a fairly
648
recent version of OpenSSL (1.1). This is available in Debian Stretch (9.x),
649
but not Jessie (8.x) (on which Volumio, for example is based at this
650
moment (12-2018)). If you are running Jessie, there is a fairly easy
651
workaround available by building a static version of openssl and telling
652
upmpdcli what version to use. See <<OHCREDS-OPENSSL, some instructions in
653
this annex>>.
654
647
655
648
The media service icons will appear in the Control Point interface, and the
656
The media service icons will appear in the Control Point interface, and the
649
service will be accessible after entering the login and password.
657
service will be accessible after entering the login and password.
650
658
651
NOTE: the user name and password will be stored on the renderer in an
659
NOTE: the user name and password will be stored on the renderer in an
...
...
1416
display a reasonably self-explanatory interface.
1424
display a reasonably self-explanatory interface.
1417
1425
1418
Recent *upmpdcli* packages install the web app as a service named
1426
Recent *upmpdcli* packages install the web app as a service named
1419
*scweb*. The service is not started by default though, you need to edit
1427
*scweb*. The service is not started by default though, you need to edit
1420
`/etc/default/scweb`.
1428
`/etc/default/scweb`.
1429
1430
[[OHCREDS-OPENSSL]]
1431
== Annex: building openssl for Debian Jessie
1432
1433
The OHCredentials service needs OpenSSL 1.1 but Debian Jessie only has
1434
1.0. The following recipee builds a static version of the openssl command,
1435
which is installed with a specific name (upmpdcli-openssl). No libraries
1436
are installed and the standard command is left undisturbed, so that there
1437
is no risk of damaging the system.
1438
1439
Note that I am making no claims about the security of the encryption
1440
provided by this method. This should be fairly sufficient for a Qobuz
1441
password going around your local network though (except maybe if you think
1442
that the NSA is interested in your playlists).
1443
1444
----
1445
sudo apt install git make gcc
1446
cd 
1447
git clone https://github.com/openssl/openssl.git
1448
cd openssl
1449
git checkout -b origin/OpenSSL_1_1_0-stable
1450
./config
1451
make
1452
cc -o upmpdcli-openssl apps/*.o  libssl.a libcrypto.a -ldl -lpthread
1453
sudo cp upmpdcli-openssl /usr/bin
1454
----
1455
1456
1457
Then edit '/etc/upmpdcli.conf' and add the following:
1458
1459
    opensslcmd = /usr/bin/upmpdcli-openssl
1460
1461
We chose to copy the command to '/usr/bin', but this could be any
1462
place. Change the path in '/etc/upmpdcli.conf' in this case.
1463
1464
Restart upmpdcli, and the logins from Kazoo should work.