-*- Text -*-

KBeam - a KDE application that lets you send and receive files to devices,
using your Infrared port.


Requirements
============

* KDE >= 3.2.
* linux supported ir device.
* IrDA enabled in kernel.
* Open Obex >= 0.96


Resources
=========

KBeam web page:
  * http://freshmeat.net/projects/kbeam/
  * http://www.kde-apps.org/content/show.php?content=14683

Latest version of KBeam is found here:
  * http://sourceforge.net/projects/kbeam/

KDE:
  * http://www.kde.org/

Open OBEX library:
  * http://openobex.sourceforge.net/


Upgrading
=========

Read the following if you're upgrading from version 0.1 :
You should uninstall version 0.1 because the installation was flawed and a lot 
of files were misplaced. Download kbeam-0.1 (from sourceforge), configure, make,
then make uninstall (being root for the last instruction). Then install the new
version.


Installation
============

Read INSTALL for installation instructions.


Instructions
=============

Once the installation is done, run "kbeam" (no quotes) and the icon should
appear in your system tray. When it detects a device in range, the icon
should light up. You can now send and receive files. You can click on the icon
(or choose Show Devices by right clicking on the icon) to open up a dialog that
shows all devices in range. To receive a file, all you have to do is make sure
the device sends and KBeam should automatically receive it and save it. To send
a file, right click on the file to send, go in Actions and you should find the
entry Beam (it only appears if there are devices in range). Select it to send
the file. That's it. Don't forget to go in the configuration dialog and adapt
it to your needs (right click on icon).

I tested this program under linux 2.6.7 (Gentoo) on my Acer Ferrari 3000
laptop. I was able to send and receive files to a Palm Zire 71, to a
Sony Ericsson T310 phone, a Sony Ericsson Z600 phone and a Toshiba laptop
running Windows XP.

**************IMPORTANT**************
Make sure /proc/sys/net/irda/max_baud_rate is set to 115200.
Anything higher may cause problems with some devices ! Mine was set to a
ridicoulously high number (16000000) and this was causing problems with
some devices (like my SE Z600 or WinXP). After setting
the value to 115200, all the devices worked like a charm ! You can check
the value by running the following command :
   $ cat /proc/sys/net/irda/max_baud_rate
If the output is anything bigger than 115200, run this :
   # echo 115200 > /proc/sys/net/irda/max_baud_rate
Notice the #, which means you have to be root. You can then check the
value again to make sure it was changed. Then, restart your irda device.
That will depend on your distribution, and, under Gentoo, is done by
running the following command :
   # /etc/init.d/irda restart

This software is still Beta. It may contain bugs and/or annoyances.
Only your feedback will help me get this software better. You can use the 
Repost A Bug dialog in the help menu (right click on the KBeam icon) or
email me directly.

That's it :)


Known bugs & TODO
=================

Read TODO.


FAQ
===

None yet.


Support
=======

You can email me at : georgesak__AT__spymac__DOT__com. I'll create a FAQ as soon
as I start receiving questions, if ever.


Donations
=========

If you're feeling generous and this application saves you time and/or money,
you can donate any amount. Just go on http://sourceforge.net/projects/kbeam/
and use the appropriate link. A small percentage of all donations will go
to Kde.org for their wonderful desktop.


Thanks
======

I'd like to thank the following people/parties :

  * Kde.org, for a wonderful desktop
  * Openobex, without this library, there would be no KBeam
  * KBluetooth, because a lot of my code has been inspired 
    (sometimes too much !) from their code
  * My girlfriend, for sticking with me for so long !
