<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="sharing-bluetooth" xml:lang="hi">

  <info>
    <link type="guide" xref="bluetooth"/>
    <link type="guide" xref="sharing"/>
    <link type="guide" xref="prefs-sharing"/>

    <revision pkgversion="3.8.2" date="2013-05-13" status="draft"/>
    <revision pkgversion="3.10" date="2013-11-09" status="review"/>
    <revision pkgversion="3.12" date="2014-03-08" status="candidate"/>
    <revision pkgversion="3.14" date="2014-10-13" status="candidate"/>

    <credit type="author">
      <name>Michael Hill</name>
      <email its:translate="no">mdhillca@gmail.com</email>
      <years>2014</years>
    </credit>
    <credit type="author">
      <name>David King</name>
      <email its:translate="no">davidk@gnome.org</email>
      <years>2014</years>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <desc>Allow files to be uploaded to your computer over Bluetooth.</desc>
  </info>

  <title>Control sharing over Bluetooth</title>

  <p>You can configure <gui>Bluetooth Sharing</gui> to control access to your
  <file>Downloads</file> folder for Bluetooth file sharing, and also restrict
  that access to only <em>trusted devices</em>.  Trusted devices are ones which
  you have <link xref="bluetooth-connect-device">paired</link> to your computer
  before.</p>

  <note style="info package">
    <p>You must have the <app>GNOME User Share</app> package installed for
    <gui>Bluetooth Sharing</gui> to be visible.</p>

    <if:choose xmlns:if="http://projectmallard.org/if/1.0/">
      <if:when test="action:install">
        <p><link action="install:gnome-user-share" style="button">Install GNOME
        User Share</link></p>
      </if:when>
    </if:choose>
  </note>

  <steps>
    <title>Allow files to be shared into your <file>Downloads</file> folder</title>
    <item>
      <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
      start typing <gui>Sharing</gui>.</p>
    </item>
    <item>
      <p>Click on <gui>Sharing</gui> to open the panel.</p>
    </item>
    <item>
      <p>If <gui>Sharing</gui> is <gui>OFF</gui>, switch it to
      <gui>ON</gui>.</p>
    </item>
    <item>
      <p>Select <gui>Bluetooth Sharing</gui>.</p>
    </item>
    <item>
      <p>Switch <gui>Save Received Files to Downloads Folder</gui> to
      <gui>ON</gui>.</p>
    </item>
    <item>
      <p>If you only want to allow trusted devices to access your
      <file>Downloads</file> folder, switch
      <gui>Only Receive From Trusted Devices</gui> to <gui>ON</gui>.</p>

      <note style="tip">
        <p>This option is disabled by default. You should enable it if you want
        to prevent access to your shared files by anyone with a
        Bluetooth-enabled cell phone or similar device nearby.</p>
      </note>

    </item>
    <item>
      <p>Click <gui style="button">Close</gui>. Bluetooth-enabled devices will
      now be able to send files to your <file>Downloads</file> folder.</p>
    </item>
  </steps>

  <note style="tip">
    <p>You can <link xref="sharing-displayname">change</link> the name your
    computer displays to other devices.</p>
  </note>

  <p><app>Files</app> allows you to launch the <gui>Sharing</gui> panel
  directly by clicking the <gui>Preferences</gui> button when you visit the
  <file>Downloads</file> folder.</p>

</page>
