# mate-bluetooth Manual

2009 Baptiste Mille-Mathias

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual.

This manual is part of a collection of MATE manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the license to the manual, as described in section 6 of the license.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any MATE documentation, and the members of the MATE Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:

1. DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.

Baptiste Mille-Mathias
MATE Documentation Project

                            baptiste.millemathias@gmail.com

1.0
March 2009

Baptiste Mille-Mathias baptiste.millemathias@gmail.com

This manual describes version 2.28 of mate-bluetooth.

Feedback

To report a bug or make a suggestion regarding the mate-bluetooth application or this manual, follow the directions in the MATE Feedback Page .

mate-bluetooth is an application to manage Bluetooth devices in the MATE desktop.

## Introduction

mate-bluetooth is an application that let you manage Bluetooth in the MATE destkop.

- mate-bluetooth permits to send files to your Bluetooth devices, or browse their content.

- Connect to your devices, like headset or audio gateway.

- You can add or delete Bluetooth devices, or manage their permissions.

## Bluetooth Applet

The applet is the resident application you can find in the notification applet, that let you quickly access to the features, like sending files, or managing your devices.

Bluetooth Applet icon in notification tray

### Starting Bluetooth Applet

The mate-bluetooth applet is started automatically when you log into your session, and you can find its icon in the notification zone. To launch manually the applet, open menu Applications Accessories Terminal and type `bluetooth-applet`.

To prevent launching of the applet in your desktop, open menu System Preferences Session and disable Bluetooth Manager.

### Turning off your Bluetooth adapter

Disabling your Bluetooth adapter will stop current and all future communications from and to your Bluetooth adapter. Disabling your Bluetooth adapter permits to save power of your laptop's battery, so it'll increase the autonomy, this is a good idea to disable your Bluetooth device when you don't use it.

Click on the icon of the applet, and choose Turn Off Bluetooth, the notification icon will become grey.

### Sending files to Bluetooth device

Choose this menu to send a file to a device; a file chooser will appear to pick up the file to send and you'll have to select the device to send the file to.

### Browsing Bluetooth device

Choose this menu to browse the device filesystem directly in your file manager.

### Last used devices

This section displays your paired devices you can connect to.

To connect to the device, click on its name, which will become bolded to inform you're connect to it.

### Adding a new device

To add a new device (which consist of pairing your adapter with your device), click on the applet icon, and choose Setup new device.... An graphical assistant will help you in the process of setting up your device.

Don't forget to set your remote device in discoverable mode before starting the process, else the wizard won't be able to find it.

The wizard will present the discoverable devices it has found all around. You can filter out the list of devices by choosing the type of devices you're looking for.

Device search in wizard

If your device has a harcoded passkey, choose Passkey Options..., in the new dialog, choose the passkey to use.

Choose Forward for the pairing step; if you defined a fixed passkey in the previous step the pairing will occur automatically, else you'll be presented a passkey to enter in your device, type it on your device, once done the devices and your adapter will be paired.

### Preferences

Click on the icon of the applet, and choose Preferences , the preferences dialog will appear.

For more information about preferences, see section

## Preferences

The mate-bluetooth preference dialog allows you to manage your various Bluetooth devices or change properties of your Bluetooth adapter(s).

Preferences dialog

### Discoverable

When your adapter is set to Discoverable any Bluetooth device around will be able to see it, and therefore will able to ask pairing.

Bluetooth as other network types implies security risks, so setting your adapter undiscoverable to other devices is a good thing to do to limit the possibility of cracking.

This is only useful to set your device discoverable if you plan to pair it with another device, once it is done, you can untick Discoverable.

When your device is undiscoverable, communication with already paired Bluetooth devices is possible.

### Adapter friendly name

The friendly name is an alias for the address used to identified each Bluetooth device much easier to remind.

By default the adapter friendly name is `HOSTNAME`-0 (where `HOSTNAME` is the name of your computer), to change it, edit the text entry and set the name you want. the change will be immediatly effective.

### Known Devices

Known devices lists the Bluetooth devices you paired and let you manage them, like deleting them, connect to them or adding new one.

- Setup new device, as described in

- Connect / Disconnect to a device.

- Device Deletion. Deletion will suppress pairing between the adapter and the device, and no communication will be allowed. You need to pair them together again if you want transfer files for instance.

### Show Bluetooth icon

You can show or hide Bluetooth icon in the panel. See for the applet features.

If you disable the icon in the panel, only limited set of actions will remain available.

### Receive Files

Click on the Receive Files button and the Personal File Sharing Preferences dialog will appear. You can configure Bluetooth file reception and sharing there.

This feature is not provided by mate-bluetooth. mate-user-share must be installed to use this feature.

Read more in the Personal File Sharing Manual: receiving and sharing.

## Frequently Asked Questions

I don't see how to receive files over Bluetooth on my computer in mate-bluetooth, am I blind?

File reception is not implemented in mate-bluetooth, but in mate-user-share, so you have to install this application to be able to receive files over Bluetooth. Button explained in the is just a launcher of its configuration dialog.

I found a bug in mate-bluetooth what I can do?

You should submit a bug report to .

mate-bluetooth
Bluetooth
Communication