From 5323e4722e363e56b7ea4af0a57e3ebcc56e5d4f Mon Sep 17 00:00:00 2001
From: tiyn <tiyn@mail-mk.eu>
Date: Fri, 7 Jul 2023 00:42:06 +0200
Subject: [PATCH] bluetooth: added bluez and bluetooth

---
 wiki/bluetooth.md   |  8 ++++++++
 wiki/linux/bluez.md | 29 +++++++++++++++++++++++++++++
 wiki/mail.md        |  4 ++--
 3 files changed, 39 insertions(+), 2 deletions(-)
 create mode 100644 wiki/bluetooth.md
 create mode 100644 wiki/linux/bluez.md

diff --git a/wiki/bluetooth.md b/wiki/bluetooth.md
new file mode 100644
index 0000000..e58c463
--- /dev/null
+++ b/wiki/bluetooth.md
@@ -0,0 +1,8 @@
+# Bluetooth
+
+[Bluetooth](https://www.bluetooth.com/) is a short-range technology for wireless
+data transfer.
+
+For [Linux](/wiki/linux/linux.md) based operating systems the
+[bluez package](/wiki/linux/bluez.md) is used as the implementation of the
+bluetooth standard.
diff --git a/wiki/linux/bluez.md b/wiki/linux/bluez.md
new file mode 100644
index 0000000..60c3df8
--- /dev/null
+++ b/wiki/linux/bluez.md
@@ -0,0 +1,29 @@
+# BlueZ
+
+[BlueZ](http://www.bluez.org/) is an implementation of the
+[Bluetooth](/wiki/bluetooth.md) standard.
+This entry features the BlueZ package and all software that is based on it.
+
+## Setup
+
+On most linux distributions BlueZ can be installed with the `bluez` package.
+Additionally the `bluez-utils` package needs to be installed.
+To load the kernel module `modprobe btusb` needs to be run.
+Afterwards the
+[service](/wiki/linux/systemd.md#startstopenabledisable-a-service) can be
+started and enabled by running the following commands.
+
+```sh
+systemctl start bluetooth.service
+systemctl enable bluetooth.service
+```
+
+## Usage
+
+The Bluetooth features can be managed by different types of front-ends.
+
+- `bluetoothctl` is a command-line interface included in the `bluez-utils`
+  package
+- `bluetuith` can be used as a bluetooth manager with a terminal user interface
+  It is included in a package of the same name, that needs to be installed
+  before usage.
diff --git a/wiki/mail.md b/wiki/mail.md
index f7fd7b6..cc3d742 100644
--- a/wiki/mail.md
+++ b/wiki/mail.md
@@ -20,5 +20,5 @@ If you don't have a built-in web interface for your mail-server you need some
 software to access your mails.
 And even if you have it can be useful to keep your mails synced locally on your pc.
 
-- [Neomutt](linux/neomutt.md) is a terminal-based mail client, that has a simple
-  interface.
+- [Neomutt](linux/neomutt.md) is a terminal-based mail client for linux, that
+has a simple interface.