====== thunar-shares-plugin ======

===== About =====
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 =====
{{:projects:thunar-plugins:thunar-shares-plugin.png|:projects:thunar-plugins:thunar-shares-plugin.png}}

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




===== Downloads =====

==== Version 0.2 ====

[[http://goodies.xfce.org/releases/thunar-shares-plugin/ChangeLog|ChangeLog]]

[[http://goodies.xfce.org/releases/thunar-shares-plugin/MD5SUMS|MD5SUMS]]

[[http://goodies.xfce.org/releases/thunar-shares-plugin/thunar-shares-plugin-0.2.0.tar.gz|thunar-shares-plugin-0.2.0.tar.gz]]


==== Xubuntu packages ====

[[https://launchpad.net/~danielmorales/+archive/ppa/|Packaged to: i386 and amd64]]

==== Subversion ====

[[http://svn.xfce.org/svn/goodies/thunar-shares-plugin/]]

===== Dependencies =====
    * Thunar
    * Thunar-VFS (0.8 or above)
    * Thunarx (0.8 or above)
    * Gtk+-2.0 (2.12 or above)
    * Glib-2.0 (2.10 or above)

===== 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



===== Setup Samba =====
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 ====

    /etc/init.d/samba restart

==== Logout and login your user (your_username) ====

===== Reporting Bugs =====

Bugs should be reported to the [[http://bugzilla.xfce.org|Xfce bug tracking system]] (product ''Thunar Plugins'', component ''thunar-shares-plugin'').