Bemused Version 1.73 Linux Server
----------------------------------

Bemused is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

You can find copy of the GNU General Puplic Licens in the file
COPYING.


Copyright (C) 2003 Ashley Montanaro  ashley_montanaro@hotmail.com
Linux Server written by Daniel Winter dw@danielwinter.de


0. News 
--------------------------------------------------------------------------

Hello, 

it has been a long time since the last linux version. Sorry, for that. 
I didn't have enough time to do it. But in the future i hope do bring new
versions faster. 

I am happy to say that this version is the best version you ever have had. 
Thanks to all the people out there which sends me bugfixes and so on, i wasn't 
ever fair to them and didn't reply to their mail, but all of there bugfixes are
included here.

Ashley Montanaro stoped the development of Bemused. Thank you Ashley for the good
work on Bemused. Alex Ibrado took over the job. He has got a lot of new ideas (for
example custom commands) and his first release Version 1.8 will be there soon. 
I will try to support Client Version 1.8 as fast as possible.

Bemused has got a new Website, with a Forum. I am there too, so you can post questions
there. You can find it here: http://bemused.sourceforge.net/

What is new in Version 1.73:

- complete support of all protocol v1.73 commands
- option to start bemused as daemon (with -d)
  (with virtxmms it is poosible to use bemused without X on a standalone mp3 Server!)
- a lot of bugfixes (i hope no more segfaults and correct handling of big file lists)

for details see ChangeLog


Regards

Daniel Winter (dw@danielwinter.de)


1. What you need
-------------------

A Symbian OS phone (Series 60 or UIQ, there are clients for both) or 
any other device with a bemusedclient (on the bemused website you can find
a link to a PalmOS-Version) with Version 1.73 installed on it. Information on the
installation of the Client can found in the documentation of the windows version.

A PC with Linux running on it. (mhh, i think any 2.x Linux will work)
The gcc compiler with the gnu utils. (normaly you have them when you use linux)

While the Windows version uses Winamp as mp3 player bemused for Linux uses
the XMMS. You can get xmms (a nice mp3 Player which looks like Winamp on
Windows under http://www.xmms.org).

Because xmms is an x-application you need an x-server, which is also standard on
a normal linux distribution.

A BT-Adapter for the PC *G*. And for Linux the bluez protocol stack installed.
Since version 1.7 you can also use the AFFIX protocol stack, but the bluez support is
more tested, because it is used the complete time by me for bemused.


2. How to install
----------------------

(here i say how to use it with bluez as protocol stack if you want to use affix look  in the docs in the directory affix-docs. If you want to try the new untested
 tcp/ip stuff you must see bemused.conf and then know by yourself how to do
 it. *G*)

If you are unsure if you want to use affix or bluez just use bluez and read here.

(If you want to upgrade from an old Version of Bemused just, install it new :-))

First check if the BT-Adapter is working correctly.

You need the Bluetooth protocol stack from http://bluez.sourceforge.com
installed. (in the newer linux kernels the bluetooth kernel module is in the kernel source
and can be build in the kernel or as module).

The hcid daemon and the sdpd daemon must be running. (part of bluez-sdp and bluez-utils from bluez.org)

You can then try to search for your phone (Bluetooth must
be ON on the phone and you must be visible by others) with the command

hcitool scan

You shoud get the Bluetooth-Address an Name of your phone.

You then have to make a channel (i.e. 9) to a sp channel with this command:

sdptool add --channel=9 SP (since version 1.71 this not needed anymore)

The channel number is important, because you have to enter it in the config of the
bemused server.

Now you have to install the bemused server from the source code.
There for you only need to enter these commands as root (when you are in the source dir):

make install


3. Configure
----------------

Now open /etc/bemused.conf and make there the there described changes.
(no panic, most settings have default values and don't need to be changed).

4. Starting
----------------------

You can simply start the bemused server from the shell (x must be started)
with the command

bemusedlinuxserver

Since version 1.73 it is possible to start it as daemon with 

bemusedlinuxserver -d

This makes it possible to close the shell-Window when bemused it started or
you can use bemused with virtxmms without X on a mp3-standalone Server or some
thing like that.

You can do this as any user, which can read the mp3dirs (listed in the config
file).
However, the shutdown from the phone only works when the user who
started the server has the right to instigate a shutdown.

When everythings goes fine there should be a welcome message, xmms starts
and the text "Waiting for connection via bluetooth" is displayed. If you
don't see that, then you have probably a problem with your bluetooth system.

Now you can start the bemused client on the phone and use it (first go to
"refresh list", to receive a new list of mp3s on the pc).


5. Any problems or ideas?
------------------------------

Write me (dw@danielwinter.de) if they are especially for the linux Version
or if there are for the whole project (new features and so on) Alex Ibrado (bluetooth@ibrado.com) or go to the bemused-Website at http://bemused.sourceforge.net/ and post in the forum.

I will try to help if i can and if I have time.

Look also in the TODO and ChangeLog file.

Regards

 Daniel Winter

