= ABOUT =

fuse-zip is a FUSE file system to navigate, extract, create and modify ZIP
archives based in libzip implemented in C++.

With fuse-zip you really can work with ZIP archives as real directories.
Unlike KIO or Gnome VFS, it can be used in any application without
modifications.

Unlike other FUSE filesystems, _only_ fuse-zip provides write support to ZIP
archives. Also, fuse-zip is faster that all known implementations on large
archives with many files.

You can download fuse-zip at http://code.google.com/p/fuse-zip



= AUTHOR =

Alexander Galanin
  * E-mail:     al@galanin.nnov.ru
  * XMPP:       gaa@jabber.ru
  * Homepage:   http://galanin.nnov.ru/~al/



= LICENSE =

fuse-zip are licensed under GNU LGPL v3.



= USAGE =

{{{
$ mkdir /tmp/zipArchive
$ fuse-zip foobar.zip /tmp/zipArchive
(do something with the mounted file system)
$ fusermount -u /tmp/zipArchive
}}}

If ZIP file does not exists, it will be created after filesystem unmounting.

Be patient. Wait for fuse-zip process finish after unmounting especially on
a big archives.

If you want to specify character set conversion for file names in archive,
use the following fusermount options:

  -omodules=iconv,from_code=$charset1,to_code=$charset2

Those Russian who uses archives from the "other OS" should use CP866 as
'charset1' and locale charset as 'charset2'.

See FUSE documentation for details.

Look at /var/log/user.log in case of any errors.



= PERFORMANCE =

On a small archives fuse-zip have the same performance with commonly used
virtual filesystems like KIO, Gnome GVFS, mc vfs, unpackfs, avfs, fuse-j-zip.
But on large archives with many file (like zipped Linux kernel sources)
fuse-zip have the greatest speed.
You can download test suite from the web-site and make sure that it is true.
See PerformancePage for details.


= HINTS =

# Added/changed files resides into memory until you unmount file system.
# Adding/unpacking very big files(more than one half of available memory) may cause your system swapping. It is a good idea to use zip/unzip in that case :)
# After adding/modifying files in archive it will be repacked at filesystem unmount. Hence, your file system must have enough space to keep tempopary files.
