blueman-project/blueman

Blueman is a GTK+ Bluetooth Manager

Python

1,579

2,359 commits

updated Oct 12, 2026

See the code

README

Description

Blueman is a GTK+ Bluetooth Manager

Blueman is designed to provide a simple yet effective means for controlling the BlueZ API and simplifying Bluetooth tasks, such as:

  • Connecting to dial-up networks
  • Connecting to / Creating Bluetooth networks
  • Connecting to input devices
  • Connecting to audio devices
  • Sending / Receiving files via OBEX
  • Pairing

It is lightweight, easy to use, Python based, and GPL licensed.

Installing

See Dependencies.md for a list of build and runtime dependencies.

To install a packaged release of blueman, run ./configure && make && make install.

To generate and run a configure script from source, run ./autogen.sh.

If you are packaging it for your distribution, please make sure to pass --disable-schemas-compile and run glib-compile-schemas /datadir/glib-2.0/schemas as part of your (un)install phase.

Packaging status

Support / Troubleshooting

If you're reporting a bug, please read the Troubleshooting page to provide all relevant info.

Feel free to open a GitHub issue to file bugs, or ask about anything you need help with.

Contributing

Fork, make your changes, and issue a pull request. If you just want to edit a single file, GitHub will guide you through that process.

Translate

Translations are managed on Hosted Weblate.

Translation status

License

All parts of the software are licensed under GPLv3 (or GPLv2) and allow redistribution under any later version.

bluetooth
bluez
gtk
linux
python-library

blueman-project/blueman

Blueman is a GTK+ Bluetooth Manager

Python

1,579

2,359 commits

updated Oct 12, 2026

See the code

README

Description

Blueman is a GTK+ Bluetooth Manager

Blueman is designed to provide a simple yet effective means for controlling the BlueZ API and simplifying Bluetooth tasks, such as:

  • Connecting to dial-up networks
  • Connecting to / Creating Bluetooth networks
  • Connecting to input devices
  • Connecting to audio devices
  • Sending / Receiving files via OBEX
  • Pairing

It is lightweight, easy to use, Python based, and GPL licensed.

Installing

See Dependencies.md for a list of build and runtime dependencies.

To install a packaged release of blueman, run ./configure && make && make install.

To generate and run a configure script from source, run ./autogen.sh.

If you are packaging it for your distribution, please make sure to pass --disable-schemas-compile and run glib-compile-schemas /datadir/glib-2.0/schemas as part of your (un)install phase.

Packaging status

Support / Troubleshooting

If you're reporting a bug, please read the Troubleshooting page to provide all relevant info.

Feel free to open a GitHub issue to file bugs, or ask about anything you need help with.

Contributing

Fork, make your changes, and issue a pull request. If you just want to edit a single file, GitHub will guide you through that process.

Translate

Translations are managed on Hosted Weblate.

Translation status

License

All parts of the software are licensed under GPLv3 (or GPLv2) and allow redistribution under any later version.

bluetooth
bluez
gtk
linux
python-library

Project health

Overall

5.0/10

Maintained

3/10

Code review

10/10
OpenSSF Scorecard

Significant stargazers

Peter Dave Hello

1,871 followers · starred Jul 2021

Steven Allen

796 followers · starred Nov 2013

Adolfo Jayme-Barrientos

62 followers · starred Jun 2022

Samuel Ainsworth

342 followers · starred Jan 2026