Warning, /plasma/bluedevil/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
0003 "dtd/kdedbx45.dtd" [
0004 <!ENTITY bluetooth "<application>Bluetooth</application>">
0005 <!ENTITY % addindex "IGNORE">
0006 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
0007 ]>
0008 
0009 <article id="bluedevil" lang="&language;">
0010     <articleinfo>
0011         <title>Bluedevil</title>
0012         <authorgroup>
0013             <author><firstname>Yuri</firstname><surname>Chornoivan</surname>
0014                 <email>yurchor@ukr.net</email></author>
0015             <!-- TRANS:ROLES_OF_TRANSLATORS -->
0016         </authorgroup>
0017         
0018         <date>2022-06-05</date>
0019         <releaseinfo>Plasma 5.25</releaseinfo>
0020         
0021         <keywordset>
0022             <keyword>KDE</keyword>
0023             <keyword>Systemsettings</keyword>
0024             <keyword>bluetooth</keyword>
0025             <keyword>phone</keyword>
0026             <keyword>headphones</keyword>
0027             <keyword>earphones</keyword>
0028             <keyword>modem</keyword>
0029             <keyword>computer</keyword>
0030             <keyword>headset</keyword>
0031             <keyword>multimedia</keyword>
0032             <keyword>device</keyword>
0033             <keyword>keyboard</keyword>
0034             <keyword>mouse</keyword>
0035             <keyword>joypad</keyword>
0036             <keyword>tablet</keyword>
0037             <keyword>camera</keyword>
0038             <keyword>printer</keyword>
0039             <keyword>imaging</keyword>
0040             <keyword>wearable</keyword>
0041             <keyword>toy</keyword>
0042             <keyword>health</keyword>
0043             <keyword>peripheral</keyword>
0044             <keyword>network</keyword>
0045         </keywordset>
0046     </articleinfo>
0047     
0048     <sect1 id="kcmbluetooth">
0049         <title>Bluetooth</title>
0050         
0051         <para>
0052             On this page you can configure your Bluetooth devices for the &plasma; Workspace.
0053         </para>
0054         
0055         <note>
0056             <para>
0057                 Please press the <guibutton>Enable</guibutton> button to enable the &bluetooth; subsystem in your operating system.
0058             </para>
0059         </note>
0060         <screenshot>
0061             <screeninfo>&bluetooth; &systemsettings; module</screeninfo>
0062             <mediaobject>
0063                 <imageobject>
0064                     <imagedata fileref="bluetooth-kcm.png" format="PNG" />
0065                 </imageobject>
0066                 <textobject>
0067                     <phrase>&bluetooth; &systemsettings; module</phrase>
0068                 </textobject>
0069             </mediaobject>
0070         </screenshot>
0071         
0072         <para>
0073             Press the <guibutton>Configure...</guibutton> button to change the general &bluetooth; settings for your &plasma; Workspace.
0074         </para>
0075         
0076         <screenshot>
0077             <screeninfo>Configuring the general module settings</screeninfo>
0078             <mediaobject>
0079                 <imageobject>
0080                     <imagedata fileref="bluetooth-configure.png" format="PNG" />
0081                 </imageobject>
0082                 <textobject>
0083                     <phrase>Configuring the general module settings</phrase>
0084                 </textobject>
0085             </mediaobject>
0086         </screenshot>
0087         <para>
0088             You can make your &bluetooth; device <guilabel>Enabled</guilabel> and <guilabel>Visible</guilabel> for other &bluetooth; devices with the corresponding items.
0089         </para>
0090         
0091         <para>
0092             It is possible to change the &bluetooth; subsystem behavior on receiving file. Your &plasma; Workspace can <guilabel>Ask for confirmation</guilabel>, <guilabel>Accept for trusted devices</guilabel> (see the <guilabel>Trusted</guilabel> in the device settings below) and <guilabel>Always accept</guilabel> the sent files. You can also configure the folder to store the received files.
0093         </para>
0094         
0095         <para>
0096             Please press the back button at the top of the page to return to the main page of the configuration module.
0097         </para>
0098         
0099         <para id="adddevice">
0100             You can add a &bluetooth; device to the main list by clicking the <guibutton>Add...</guibutton>
0101             button. Your neighborhood will be scanned for available devices. If the device you want to use is
0102             not shown in the scanning list then you will need to consult its manual for the instructions on how to set it up.
0103         </para>
0104         
0105         <para>
0106             Configure the <guilabel>Manual PIN</guilabel> if needed and <mousebutton>left</mousebutton>-click on the detected device to pair it with your computer. See the device manual on the procedure of pairing, the mileadge may vary but usually, it is very straightforward.
0107         </para>
0108         
0109         <screenshot>
0110             <screeninfo>Adding &bluetooth; device</screeninfo>
0111             <mediaobject>
0112                 <imageobject>
0113                     <imagedata fileref="bluetooth-add.png" format="PNG" />
0114                 </imageobject>
0115                 <textobject>
0116                     <phrase>Adding &bluetooth; device</phrase>
0117                 </textobject>
0118             </mediaobject>
0119         </screenshot>
0120         
0121         <para>
0122             <mousebutton>Left</mousebutton>-click on the list item to configure its name in the devices list and make it <guilabel>Trusted</guilabel> and <guilabel>Blocked</guilabel>.
0123         </para>
0124         
0125         <screenshot>
0126             <screeninfo>Device settings</screeninfo>
0127             <mediaobject>
0128                 <imageobject>
0129                     <imagedata fileref="bluetooth-phone.png" format="PNG" />
0130                 </imageobject>
0131                 <textobject>
0132                     <phrase>Device settings</phrase>
0133                 </textobject>
0134             </mediaobject>
0135         </screenshot>
0136         
0137         <para>
0138             Please press the back button at the top of the page to return to the main page of the configuration module.
0139         </para>
0140         
0141         <para>
0142             When hovering with the mouse cursor, every &bluetooth; device in the main list shows two buttons on the right.
0143         </para>
0144         
0145         <para>
0146             Use <guiicon><inlinemediaobject><imageobject><imagedata fileref="network-connect.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> or <guiicon><inlinemediaobject><imageobject><imagedata fileref="network-disconnect.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> to connect or disconnect a device.
0147         </para>
0148         
0149         <para>
0150             You can remove a device from the main list by selecting it and then clicking on the <inlinemediaobject><imageobject><imagedata fileref="list-remove.png" format="PNG"/></imageobject></inlinemediaobject> icon.
0151         </para>
0152         
0153         <para>
0154             If you need to switch &bluetooth; off for some reason press the <guibutton>Disable &bluetooth;</guibutton> button.
0155         </para>
0156         
0157     </sect1>
0158     
0159     <sect1 id="system-tray">
0160         <title>System Tray Operation</title>
0161         
0162         <note>
0163             <para>
0164                 You must be running the &plasma; desktop or another suitable window manager in order to display &bluetooth; in the system tray.
0165             </para>
0166         </note>
0167         
0168         <para>The &bluetooth; module by default displays an icon in the system tray. The icon
0169             provides both control and monitoring status indications. A
0170             normal &bluetooth; icon indicates that all devices are disconnected,
0171             while the icon with the horizontal dotted line indicates that
0172             some devices are connected to your computer.
0173         </para>
0174         
0175         <para>
0176             If you hover the mouse cursor over the system tray icon, a
0177             summary of the connected device list is displayed as a tooltip.
0178         </para>
0179         
0180         <para>
0181             <mousebutton>Left</mousebutton>-click on the system tray icon to
0182             toggle between displaying and hiding the <link linkend="controlpanel">&bluetooth; main control panel</link>.
0183         </para>
0184         
0185         <para>
0186             <mousebutton>Right</mousebutton>-click on the system tray icon to
0187             display its context menu with just one item:
0188         </para>
0189         
0190         <variablelist>
0191             <varlistentry>
0192                 <term><menuchoice><guimenuitem>Configure &bluetooth;</guimenuitem></menuchoice></term>
0193                 <listitem><para><action>Starts the <link linkend="kcmbluetooth">&plasma; &bluetooth; configuration module</link>.</action></para>
0194                 </listitem>
0195             </varlistentry>
0196         </variablelist>
0197         
0198         <sect2 id="controlpanel">
0199             <title>The &bluetooth; main control panel</title>
0200             
0201             <para>
0202                 The &bluetooth; main control panel can be used to control your computer's &bluetooth; subsystem.
0203             </para>
0204             
0205             <screenshot>
0206                 <screeninfo>&bluetooth; tray control panel</screeninfo>
0207                 <mediaobject>
0208                     <imageobject>
0209                         <imagedata fileref="bluetooth-tray.png" format="PNG" />
0210                     </imageobject>
0211                     <textobject>
0212                         <phrase>&bluetooth; tray control panel</phrase>
0213                     </textobject>
0214                 </mediaobject>
0215             </screenshot>
0216             
0217             <para>
0218                 The top row of the panel contains the &bluetooth; switcher to enable or disable the &bluetooth; module, the <quote>plus</quote> button to <link linkend="adddevice">add &bluetooth; devices</link>, and the <quote>configure</quote> button to start the <link linkend="kcmbluetooth">&plasma; &bluetooth; configuration module</link>.
0219             </para>
0220             
0221             <para>
0222                 The main space of the panel is devoted to the paired devices.
0223             </para>
0224             <para>
0225                 Use <guiicon><inlinemediaobject><imageobject><imagedata fileref="network-connect.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> or <guiicon><inlinemediaobject><imageobject><imagedata fileref="network-disconnect.png" format="PNG"/></imageobject></inlinemediaobject></guiicon> to connect or disconnect a device.
0226             </para>
0227             
0228             <para>
0229                 Click on the <guilabel>v</guilabel> button at the right of the device item to expand its properties.
0230             </para>
0231             
0232             <para>
0233                 The <guibutton>Send file...</guibutton> button will be shown only if the corresponding device is connected and ready to receive files. This feature may need some additional software to be installed. If needed, please follow the instructions and consult your distribution documentation.
0234             </para>
0235             
0236         </sect2>
0237     </sect1>
0238     
0239 </article>