diff --git a/README.md b/README.md index 683b8cc..eef63d9 100644 --- a/README.md +++ b/README.md @@ -19,122 +19,7 @@ This project is currently in the alpha stage. - Remotely control media playback on the connected device - Mouse support -## Requirements -- Bluez -- DBus -- NetworkManager (optional, required for PANU) -- ModemManager (optional, required for DUN) -- PulseAudio (optional, required to manage device audio profiles) +## Documentation +The documentation is now hosted [here](https://bluetuith.darkhz.io) -## Installation -If the `go` compiler is present in your system, you can install it via the following command: -`go install github.com/darkhz/bluetuith@latest` - -Or you can navigate to the releases section and download a binary that matches your architecture. - -It is also available in the AUR as bluetuith-bin. - -## Usage - bluetuith [] - - Flags: - --adapter Specify an adapter to use. (For example, hci0) - --gsm-apn Specify GSM APN to connect to. (Required for DUN) - --gsm-number Specify GSM number to dial. (Required for DUN) - --list-adapters List available adapters. - --receive-dir Specify a directory to store received files. - --set-theme Specify a theme - --set-theme-config Specify a comma-separated list of modifier-color pairs. - -- To use DUN-based networking, it is required to specify the **gsm-number** option. The **gsm-apn** field is optional. - -- If the **receive-dir** option is not specified, received files will be stored in ``$HOME/bluetuith``. - -- For more information on how to use the **set-theme** and **set-theme-config** options, -navigate to the [Themes](https://github.com/darkhz/bluetuith/wiki/Themes) wiki page. - -## Configuration -bluetuith should generally work out-of-the-box, with no required configurations. - -If persistent configuration for certain settings is required, a config file can be used.
-The config file is automatically created on startup, and its location can be viewed on invoking ``bluetuith --help``. - -Configuration properties can be in the form of a simple ``name=value``or ``name value`` pair. - -For example: - - adapter=hci0 - receive-dir=/home/darkhz/bluetuith - -## Keybindings - -### Device Screen -|Operation |Keybinding | -|--------------------------------|-----------------------------| -|Open the menu |Ctrl+m | -|Navigate between menus |Tab | -|Navigate between devices/options|Up/Down| -|Toggle adapter power state |o | -|Toggle discoverable state |S | -|Toggle pairable state |P | -|Toggle scan (discovery state) |s | -|Change adapter |a | -|Send files |f | -|Connect to network |n | -|Progress view |v | -|Connect to selected device |c | -|Pair with selected device |p | -|Trust selected device |t | -|Show media player |m | -|Hide media player |M | -|Show device information |i | -|Remove device from adapter |d | -|Cancel operation |Ctrl+x | -|Quit |q | - -### File Picker -|Operation |Keybinding | -|----------------------------------|------------------------------| -|Navigate between directory entries|Up/Down | -|Enter a directory |Right | -|Go back one directory |Left | -|Select one file |Space | -|Invert file selection |a | -|Select all files |A | -|Refresh current directory |Ctrl + r| -|Toggle hidden files |Ctrl+h | -|Confirm file(s) selection |Ctrl+s | -|Exit |Escape | - -### Progress View -|Operation |Keybinding | -|--------------------------|-----------------------------| -|Navigate between transfers|Up/Down| -|Suspend transfer |z | -|Resume transfer |g | -|Cancel transfer |x | -|Exit |Escape | - -### Media Player -|Operation |Keybinding | -|-----------------|----------------| -|Toggle play/pause|Space| -|Next |> | -|Previous |< | -|Rewind |Left | -|Fast forward |Right| -|Stop |] | - -## Planned features - - [x] OBEX file transfer. - - [x] Display the device type and icon. - - [x] Display range (RSSI) of the connected device. - -## Additional notes -- Ensure that the bluetooth service is up and running, and it is visible to DBus before launching the application. With systemd you can find out the status using the following command: `systemctl status bluetooth.service`. -- Only one transfer (either of send or receive) can happen on an adapter. Attempts to start another transfer while a transfer is already running (for example, trying to send files to a device when a transfer is already in progress) will be silently ignored. - -## Credits -Special thanks to: -- **vishen**, for the bluez implementation [here](https://github.com/vishen/sluez/blob/master/bluez/device.go). -- **muka**, for the agent implementation [here](https://github.com/muka/go-bluetooth/blob/master/bluez/profile/agent/agent_simple.go). +The wiki is out-of-date.