[[http://www.softpedia.com/progClean/fileservity-Clean-142724.html|{{:docs:softpedia_free_award_f.gif|softpedia}}]]
[[http://search.brothersoft.com/fileservity|{{:docs:brothersoft.gif|brothersoft}}]]
[[http://www.downloadtube.com/Fileservity-demo-installation-windows.html|{{:docs:downloadtube_top_award.gif|downloadtube}}]]

====== fileservity ======
{{:docs:fileservity.png?nolink |fileservity}}
Fileservity is a thin http file server, opensource and cross platform.\\
With this program you can share files and folders accross the web
in a drag and drop!\\
\\
===== Download =====

last stable version: **1.0.1, 19 Mar 2010** (in a few days..)

You can get fileservity from
[[http://sourceforge.net/projects/fileservity]]

===== Install =====

Download and extract the last release archive in your local system.\\
In the extracted folder you'll find
  * the **README** text file
  * the **LICENCE** text file
  * the **fileservity** executable
Just double click fileservity to run.\\

<note>
for Windows users:

Fileservity requires the latest Microsoft C runtime library (MSVCRT).
This comes as part of the Windows system (authomatic) updates,
or you can get it directly here:

[[http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf|MSVCRT]]

</note>

===== Usage =====

Fileservity GUI consists of a triple splitted window,
with filesystem tree-view on the left side,
shares list-view and monitoring controls on the right side;
those include a log viewer and a downloads list.
Basic usage operations follow.

{{:docs:fileservity:screenshot.png?width=400|screenshot}}

==== Share items ====

Drag and drop a node (file or directory) from the left tree
to the right list, or select the node and then click the
{{:docs:fileservity:add.gif?nolink|add}}"Add" button/menu or type <key>C-+</key>.
To remove a shared item select it from the list and click
the {{:docs:fileservity:remove.gif|remove}}remove button/menu.

==== Start the service ====
      
The server will accept incoming requests to the port number
in the textbox labeled "port" on the toolbar.
You can put any port number between 1025 and 65535.

<note important>to allow public access to your service you may need to configure
your router and/or firewall accordingly.
</note>

Click the {{:docs:fileservity:start.png?nolink|start}} start button/menu.\\
The server will try to find your public IP address and start
accepting incoming request.\\
You'll notice that the start buttons will be disabled and the
{{:docs:fileservity:stop.png?nolink|stop}}stop button enabled.\\
If something went wrong (the service is not publicly visible)
you'll be warned with a log message.\\
If an address (port) is already in use, try a different number.

After service is started all incoming requests will be served
as applicable. You can monitor http traffic with the log
and downloads views.


==== Let 'em know ====

Choose an IP from the middle-top combo and select a shared item
in the right list: the address displayed in the top-right text box
is the public URL!
You can copy-paste it using the rightmost button.

<note>        
In the IP combo the first address is your LAN (intranet) IP.
Your public (WAN) IP, if available, will be the second.

Notice that most routers won't allow public IP addressing to LAN host.

To make a test with your local web browser you can put the
"localhost" name or the 127.0.0.1 loopback IP.
</note>

==== On the client side ====

Users will consume your service via a browser.\\
To test what thay can see copy and paste the share URL
in your browser.\\
Notice that most routers won't allow public IP addressing to LAN host,
so remeber using your LAN address or the loopback ip
(127.0.0.1 or "localhost").

==== Save your sharings ====

You can save the current share list with the {{:docs:fileservity:save.gif?nolink|save}}save menu.\\
To open a previously saved list use the {{:docs:fileservity:open.gif?nolink|open}}open menu.
The open button is disabled when the service is listening (started).


===== Licence =====
<code>
Copyright (C) 2009 Attilio Pavone <tilly@utillyty.eu>

Fileservity is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Fileservity is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You can find a copy of the GNU General Public License in the file
LICENSE, or can see <http://www.gnu.org/licenses/>.
</code>
This software uses the following open source libraries:
  * utillyty ([[http://www.utillyty.eu]])
  * FOX toolkit ([[http://www.fox-toolkit.org]]) version 1.6.35
  * libpng ([[http://www.libpng.org]]) version 1.2.35
  * zlib ([[http://www.zlib.net]]) version 1.2.3

===== Develope =====


You can get the last source distribution from the sourceforge
project files page:

[[https://sourceforge.net/projects/fileservity/files/]]

or access the current developing sources via cvs:

  cvs -d:pserver:anonymous@fileservity.cvs.sourceforge.net:/cvsroot/fileservity login

Fileservity is statically linked to utillyty.cpp:

  cvs -d:pserver:anonymous@u-omnibus.cvs.sourceforge.net:/cvsroot/u-omnibus login

and FOX toolkit 1.6.35:

[[http://www.fox-toolkit.org/ftp/fox-1.6.36.zip]]     (windows)\\
[[http://www.fox-toolkit.org/ftp/fox-1.6.36.tar.gz]]  (linux)

To build FOX you also need libpng (http://www.libpng.org) version 1.2.35
and zlib (http://www.zlib.net) version 1.2.3.

In the source distribution you can find a Visual C++ and a Code::Blocks
project under the <build> directory.\\
Projects directory layout is:

<code>
+ ..
  + _opensource

    * fox-1.6.35
    * libpng-1.2.35
    * zlib-1.2.3

  + UTillyty

    * fileservity
    * utillyty.cpp
</code>

===== Revision history =====

=== version 0.1.0 (beta-1), 16 Oct 2009 ===

This is the first open beta version.
Project has been alpha tested in Windows XP professional SP2
and Ubuntu 8.04.
There are still some multithreading issues, but it's working ;).

=== version 1.0.0, 23 Oct 2009 ===

  * **NEW**: download restoring\\
added management for restoring interrupted downloads

  * **BUG**: SIGPIPE\\
On linux there was an unhandled SIGPIPE signal
when connection was closed remotely.

  * **BUG**: root list\\
Files in the root (virtual) directory where listed as directories.

=== version 1.0.1, 19 Mar 2010 ===

resolved a minor bug that made occasionally crash the UI under linux