Difference between revisions of "Blueman"

From ArchWiki
Jump to: navigation, search
(Not directly related.)
m (→‎Workaround for a Bug with obex and gvfs)
(27 intermediate revisions by the same user not shown)
Line 7: Line 7:
  
 
== Installation ==
 
== Installation ==
−
{{warning|Blueman relies on the obsolete [[Bluez4]] stack. It is recommended that you use the {{pkg|bluez}} version 5 stack for bluetooth functionality. More information on configuring bluetooth with Bluez5 can be found in the [[Bluetooth]] article.}}
+
{{warning|Blueman currently relies on the, now unmaintained, [[Bluez4]] stack. A version of Blueman that is compatible with Bluez5 is in development. [https://github.com/blueman-project/blueman/tree/bluez5]}}
  
 
Blueman can be installed from the {{AUR|blueman-bzr}} package in the [[AUR]].
 
Blueman can be installed from the {{AUR|blueman-bzr}} package in the [[AUR]].
  
 
Be sure to enable the [[Bluetooth]] daemon and start Blueman with {{ic|blueman-applet}}.
 
Be sure to enable the [[Bluetooth]] daemon and start Blueman with {{ic|blueman-applet}}.
 +
 +
{{Tip|If you want to mount and browse remote devices, you may need to install the {{AUR|gvfs-obexftp-bluez4}} package from the [[AUR]].}}
  
 
== Usage ==
 
== Usage ==
  
−
Be sure the local Bluetooth device is availabe by running {{ic|hcitool dev}}. If only {{ic|Devices:}} is dumped, the local Bluetooth device is unavailable. You may restart the ''bluetooth'' service or toggle the WiFi/Bluetooth switch of your laptop, for example {{ic|Fn+F3}} in Acer Aspire or reboot to activate the local Bluetooth device. If you run {{ic|blueman-applet}} without available local Bluetooth device, the Blueman tray icon will not appear.
+
=== Checking the Bluetooth hardware ===
  
−
Then execute {{ic|blueman-applet}}, and the Blueman tray icon will show up. {{ic|/etc/xdg/autostart/blueman.desktop}} may have been created to autostart Blueman when loggin into X in a system-wide manner. If not, to make the applet run after login into a graphical environment automatically, add {{ic|blueman-applet}} either under ''System > Preferences > Startup Applications'' (GNOME) or ''Xfce Menu > Settings > Session and Startup'' (Xfce). Various ways to autostart a program are listed in [[Autostarting]].
+
Be sure the local Bluetooth device is availabe by running {{ic|hcitool dev}}. If only {{ic|Devices:}} is dumped, the local Bluetooth device is unavailable. If this is the case, try restarting the ''bluetooth'' service or toggle the WiFi/Bluetooth switch on your laptop (if it exists). For example: the switch is {{ic|Fn+F3}} on an Acer Aspire laptop. Also try rebooting to activate the local Bluetooth device. If you run {{ic|blueman-applet}} without an available local Bluetooth device, the Blueman tray icon will not appear.
  
−
In order for a user to add and manage Bluetooth devices using Blueman, the user must be added to the {{ic|lp}} group. See {{ic|/etc/dbus-1/system.d/bluetooth.conf}} for the section that enables users of the {{ic|lp}} group to communicate with the Bluetooth daemon.
+
=== Autostarting ===
 +
 
 +
The following autostart file should have been created: {{ic|/etc/xdg/autostart/blueman.desktop}}. This means that Blueman should be autostarted with most desktop environments without manual intervention. See the article for your desktop environment or window manager as well as the [[Autostarting]] article for further information on autostarting.
 +
 
 +
=== Permissions ===
 +
 
 +
It might be necessary for the user to be added to the {{ic|lp}} group in order for the user to be able to add and manage Bluetooth devices using Blueman. See {{ic|/etc/dbus-1/system.d/bluetooth.conf}} for the section that enables users of the {{ic|lp}} group to communicate with the Bluetooth daemon.
  
 
To receive files remember to right click on the ''Blueman tray icon > Local Services > Transfer > File Receiving" and tick the square box next to "Enabled".
 
To receive files remember to right click on the ''Blueman tray icon > Local Services > Transfer > File Receiving" and tick the square box next to "Enabled".
  
−
{{Note|If you are running Blueman outside GNOME/GDM (e.g., in Xfce using the {{ic|startx}} command) you should add {{ic|source /etc/X11/xinit/xinitrc.d/*}} on top of your {{ic|~/.xinitrc}} to make Nautilus capable to browse your devices.}}
+
{{Note|If you are running Blueman in a session that is started with the ''startx'' command, you should add {{ic|source /etc/X11/xinit/xinitrc.d/*}} to your {{ic|~/.xinitrc}} to make Nautilus capable of browsing your devices.}}
  
−
==== Generic file manager script ====
+
=== Mounting Bluetooth devices without Nautilus ===
 +
 
 +
Blueman is configured to use [[Nautilus]] for bluetooth device mounting by default. The instructions below describe a method for using different file managers with Blueman. The examples in this section focus on [[Thunar]]. If you are using a different file manager, substitute ''thunar'' with the name of the file manager you are using.
  
−
If you are not using Nautilus (for example Thunar) you may find the following script useful:
 
 
{{hc|obex_thunar.sh|
 
{{hc|obex_thunar.sh|
 
#!/bin/bash
 
#!/bin/bash
Line 34: Line 43:
 
thunar ~/bluetooth
 
thunar ~/bluetooth
 
}}
 
}}
 +
 
Now you will need to move the script to an appropriate location (e.g., {{ic|/usr/local/bin}}). After that, mark it as executable:
 
Now you will need to move the script to an appropriate location (e.g., {{ic|/usr/local/bin}}). After that, mark it as executable:
 
  # chmod +x /usr/local/bin/obex_thunar.sh
 
  # chmod +x /usr/local/bin/obex_thunar.sh
 +
 
The last step is to change the line in ''Blueman tray icon > Local Services > Transfer > Advanced'' to {{ic|obex_thunar.sh %d}}.
 
The last step is to change the line in ''Blueman tray icon > Local Services > Transfer > Advanced'' to {{ic|obex_thunar.sh %d}}.
  
−
== Blueman and PulseAudio ==
+
{{Tip|If you do not want to create a script, you could just replace this command: {{ic|nautilus --browse obex://}} with this one: {{ic|thunar obex://}} in ''Local Services > Transfer > Advanced''}}
 +
 
 +
=== Blueman and PulseAudio ===
  
 
Users who want to use [[PulseAudio]] with a Bluetooth headset may want to activate the PulseAudio plugin of Blueman. This automatically loads PulseAudio Bluetooth module after audio device is connected and plays all audio through the Bluetooth headset.
 
Users who want to use [[PulseAudio]] with a Bluetooth headset may want to activate the PulseAudio plugin of Blueman. This automatically loads PulseAudio Bluetooth module after audio device is connected and plays all audio through the Bluetooth headset.
  
 
== Troubleshooting ==
 
== Troubleshooting ==
−
 
−
=== Blueman and Thunar ===
 
−
 
−
Install the {{AUR|gvfs-obexftp-bluez4}} package from the [[AUR]] to browse files remotely in [[Thunar]] using Blueman. Open up the Blueman services configuration window and replace:
 
−
nautilus --browse obex://
 
−
with:
 
−
thunar obex://
 
  
 
=== Workaround for a Bug with obex and gvfs ===
 
=== Workaround for a Bug with obex and gvfs ===
  
 
{{Note|This bug only affects older versions of Blueman.}}
 
{{Note|This bug only affects older versions of Blueman.}}
−
To browse mobile phone via nautilus with Blueman you need a patched ''GVFS''. Install {{AUR|gvfs-rar}} from [[AUR]]. It is possible that you will need to rebuild the {{AUR|obex-data-server}} package as shown below:
+
To browse a mobile phone using [[Nautilus]] and Blueman you will need a patched version of [[GVFS]]. Install {{AUR|gvfs-rar}} from [[AUR]]. It is possible that you will need to rebuild the {{AUR|obex-data-server}} package as shown below:
 
  $ ./configure --prefix=/usr --sysconfdir=/etc
 
  $ ./configure --prefix=/usr --sysconfdir=/etc
−
 
−
=== Workaround a bug with network manager in Bluetooth networking ===
 
−
 
−
Some distributions show all Bluetooth interfaces as net.80203, which can cause strange behaviour in network manager,
 
−
for example NM trying to get dhcp address for an incoming connection.
 
−
 
−
{{Note|This bug only afflicts versions below 1.02.}}
 
−
 
−
Put this in {{ic|/etc/hal/fdi/information/bnep.fdi}}:
 
−
 
−
{{bc|<nowiki>
 
−
<?xml version="1.0" encoding="UTF-8"?>
 
−
 
−
<deviceinfo version="0.2">
 
−
<device>
 
−
  <match key="info.category" string="net.80203">
 
−
    <match key="net.interface" contains="bnep">
 
−
        <merge key="info.category" type="string">net.bluetooth</merge>
 
−
        <merge key="info.product" type="string">Bluetooth Interface</merge>
 
−
        <merge key="info.capabilities" type="strlist">net, net.bluetooth</merge>
 
−
        <merge key="net.bluetooth.mac_address" type="copy_property">net.80203.mac_address</merge>
 
−
        <remove key="net.80203.mac_address"/>
 
−
    </match>
 
−
  </match>
 
−
</device>
 
−
</deviceinfo>
 
−
</nowiki>}}
 
  
 
=== Cannot receive files ===
 
=== Cannot receive files ===
  
−
You have to edit {{ic|/etc/conf.d/bluetooth}} file and uncomment this line:
+
If you cannot receive files with Blueman, edit the {{ic|/etc/conf.d/bluetooth}} file and uncomment this line:
  
 
  #SDPD_ENABLE="true"
 
  #SDPD_ENABLE="true"
Line 94: Line 73:
 
If blueman-applet fails to start, try removing the entire {{ic|/var/lib/bluetooth}} directory and restarting the machine (or just the dbus and bluetooth services).
 
If blueman-applet fails to start, try removing the entire {{ic|/var/lib/bluetooth}} directory and restarting the machine (or just the dbus and bluetooth services).
 
  # rm -rf /var/lib/bluetooth
 
  # rm -rf /var/lib/bluetooth
−
  # reboot
+
  $ systemctl reboot
−
If you see a notification saying {{ic|Incoming file over Bluetooth}} then this means that the device isn't marked as trusted. Mark it as trusted and try again (looking at the code, it looks like some buttons should be displayed in the notification, but I don't see them).
+
If you see a notification saying {{ic|Incoming file over Bluetooth}} then this means that the device isn't marked as trusted. Mark it as trusted and try sending the file again.
 +
 
 +
== See also ==
 +
 
 +
* [https://launchpad.net/blueman Blueman development], on Launchpad
 +
* [https://github.com/blueman-project/blueman Blueman development], on GitHub

Revision as of 20:46, 22 March 2014

Blueman is a full featured Bluetooth manager written in GTK+.

Related articles

Installation

Warning: Blueman currently relies on the, now unmaintained, Bluez4 stack. A version of Blueman that is compatible with Bluez5 is in development. [1]

Blueman can be installed from the blueman-bzrAUR package in the AUR.

Be sure to enable the Bluetooth daemon and start Blueman with blueman-applet.

Tip: If you want to mount and browse remote devices, you may need to install the gvfs-obexftp-bluez4AUR package from the AUR.

Usage

Checking the Bluetooth hardware

Be sure the local Bluetooth device is availabe by running hcitool dev. If only Devices: is dumped, the local Bluetooth device is unavailable. If this is the case, try restarting the bluetooth service or toggle the WiFi/Bluetooth switch on your laptop (if it exists). For example: the switch is Fn+F3 on an Acer Aspire laptop. Also try rebooting to activate the local Bluetooth device. If you run blueman-applet without an available local Bluetooth device, the Blueman tray icon will not appear.

Autostarting

The following autostart file should have been created: /etc/xdg/autostart/blueman.desktop. This means that Blueman should be autostarted with most desktop environments without manual intervention. See the article for your desktop environment or window manager as well as the Autostarting article for further information on autostarting.

Permissions

It might be necessary for the user to be added to the lp group in order for the user to be able to add and manage Bluetooth devices using Blueman. See /etc/dbus-1/system.d/bluetooth.conf for the section that enables users of the lp group to communicate with the Bluetooth daemon.

To receive files remember to right click on the Blueman tray icon > Local Services > Transfer > File Receiving" and tick the square box next to "Enabled".

Note: If you are running Blueman in a session that is started with the startx command, you should add source /etc/X11/xinit/xinitrc.d/* to your ~/.xinitrc to make Nautilus capable of browsing your devices.

Mounting Bluetooth devices without Nautilus

Blueman is configured to use Nautilus for bluetooth device mounting by default. The instructions below describe a method for using different file managers with Blueman. The examples in this section focus on Thunar. If you are using a different file manager, substitute thunar with the name of the file manager you are using. 

obex_thunar.sh
#!/bin/bash
fusermount -u ~/bluetooth
obexfs -b $1 ~/bluetooth
thunar ~/bluetooth

Now you will need to move the script to an appropriate location (e.g., /usr/local/bin). After that, mark it as executable: 

# chmod +x /usr/local/bin/obex_thunar.sh

The last step is to change the line in Blueman tray icon > Local Services > Transfer > Advanced to obex_thunar.sh %d.

Tip: If you do not want to create a script, you could just replace this command: nautilus --browse obex:// with this one: thunar obex:// in Local Services > Transfer > Advanced

Blueman and PulseAudio

Users who want to use PulseAudio with a Bluetooth headset may want to activate the PulseAudio plugin of Blueman. This automatically loads PulseAudio Bluetooth module after audio device is connected and plays all audio through the Bluetooth headset.

Troubleshooting

Workaround for a Bug with obex and gvfs

Note: This bug only affects older versions of Blueman.

To browse a mobile phone using Nautilus and Blueman you will need a patched version of GVFS. Install gvfs-rarAUR from AUR. It is possible that you will need to rebuild the obex-data-serverAUR package as shown below: 

$ ./configure --prefix=/usr --sysconfdir=/etc

Cannot receive files

If you cannot receive files with Blueman, edit the /etc/conf.d/bluetooth file and uncomment this line: 

#SDPD_ENABLE="true"

Blueman applet does not start

If blueman-applet fails to start, try removing the entire /var/lib/bluetooth directory and restarting the machine (or just the dbus and bluetooth services). 

# rm -rf /var/lib/bluetooth
$ systemctl reboot

If you see a notification saying Incoming file over Bluetooth then this means that the device isn't marked as trusted. Mark it as trusted and try sending the file again.

See also

Retrieved from "https://wiki.archlinux.org/index.php?title=Blueman&oldid=306653"