~~NOTOC~~
{{ :xfce:thunar.png?nolink|}}
====== Thunar - thunar-shares-plugin ======

  * **[[#Required Packages|Required Packages]]**
  * **[[#Building and Installing|Building and Installing]]**
  * **[[#Samba Setup|Samba Setup]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Introduction =====
The Thunar Shares Plugin (thunar-shares-plugin) allows you to quickly share a folder using Samba
from Thunar (the Xfce file manager) without requiring root access.

----

===== Screenshots =====

<figure "Thunar Shares Preference Tab">
{{:xfce:thunar:4.18:thunar-shares-plugin.png|Thunar Share tab dialog window}}
</figure>

The share editor can be found in the file properties dialog (Share page).

----

===== Required Packages =====
 
  * [[https://gitlab.xfce.org/xfce/thunar|Thunar]]
  * Thunar-VFS (0.8 or above)
  * [[https://gitlab.xfce.org/bindings/thunarx-python|Thunarx]]
  * [[https://wiki.gnome.org/Projects/GLib|GLib]]
  * [[https://www.gtk.org|GTK+-3.0]]

For detailed information on the minimum required versions, check the [[https://gitlab.xfce.org/thunar-plugins/thunar-shares-plugin/-/blob/master/configure.ac.in|configure.ac.in]] file.

[[|Back to Top]]
----

===== Building and Installing =====
(For information about how to **setup Samba correctly** see bellow)

If you downloaded a source tarball from the download page, you can run:

  ./configure --prefix=$(pkg-config --variable prefix thunarx-1)

in order to configure the plugin. If you fetched the source from SVN, you have to use this command:

  ./autogen.sh --prefix=$(pkg-config --variable prefix thunarx-1)

After that you should be able to build and install the plugin, using the following commands (remember you have to be root for that!):

  make && make install

----

===== Samba Setup =====
If your are using **(X)ubuntu** 8.04 or above just check your **User privileges** after install the plugin. Also install **samba** and **libpam-smbpass**.


For **non** (X)ubuntu users the Samba setup is:


==== Create a group (must be done as root)  ====

    export USERSHARES_DIR="/var/lib/samba/usershares"
    export USERSHARES_GROUP="sambashare"
    mkdir -p ${USERSHARES_DIR}
    groupadd ${USERSHARES_GROUP}
    chown root:${USERSHARES_GROUP} ${USERSHARES_DIR}
    chmod 01770 ${USERSHARES_DIR}

==== Use the following /etc/samba/smb.conf (or something similar) ====

    [global]
    workgroup = WORKGROUP
    security = share
    usershare path = /var/lib/samba/usershares
    usershare max shares = 100
    usershare allow guests = yes
    usershare owner only = yes

==== Add the samba group to your user (replace your_username by your login) ==== 

    usermod -a -G ${USERSHARES_GROUP} your_username

==== Restart Samba daemons ====

sysvinit:

    /etc/init.d/samba restart

systemd:

    systemctl restart smbd
==== Logout and login your user (your_username) ====

[[|Back to Top]]
---- 

==== Latest Release ====

{{rss>https://archive.xfce.org/feeds/project/thunar-shares-plugin 1 date 2h}}

[[https://gitlab.xfce.org/thunar-plugins/thunar-shares-plugin/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/thunar-plugins/thunar-shares-plugin/|Download current release]]** (older versions of this component are also available here)

----

==== Source Code Repository ====

[[https://gitlab.xfce.org/thunar-plugins/thunar-shares-plugin]]

----

===== Reporting Bugs =====
  * **[[:xfce:thunar:thunar-shares-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports

[[|Back To Top]]
----
[[:xfce:thunar:4.18:start:|Return to Thunar 4.18 Main Documentation Page]]