Troubleshooting
The least information we typically need to help with an issue is the version of blueman you're using. In most cases the BlueZ version makes sense as well. You can use the following template to make sure you're providing the most basic information:
blueman:
BlueZ:
Distribution:
Desktop environment:
It may also be useful to provide the debugging output from the next section, sometimes even multiple examples (e.g. a working one and one where the issue comes up). Make sure to describe the exact steps you took when producing it.
To retrieve useful information, the best starting point is to run blueman-applet from a Terminal window. It needs to be shut down, since only one instance may be running. You should always be able to do that with killall blueman-applet.
There will be plenty of output in the Terminal window, also including messages from blueman-manager. If you're unsure how to get behind a given problem, please provide the full output in your error report.
The blueman-report tool is a simple helper to log blueman output. It also provides a way to comment on the steps you take while creating the log and uploads the commented log file.
Test if your device is recognized by BlueZ using bluez-test-adapater list (BlueZ 4) or bluetoothctl list (BlueZ 5).
If not, you either have some hardware killswitch enabled or the device is not supported by the Linux bluetooth stack. To check the later, you can find the hardware ID with lsusb or lspci depending on the interface to google for it.