fuse-zip(1)

💖 fuse-zip(1) — FUSE filesystem to read and modify ZIP archives 💖

okay bestie, sit down, hydrate, because we're about to make ZIP archives feel like a whole directory and honestly? iconic behavior. this is the manual for fuse-zip, a FUSE filesystem for zip archives with write support (yes, write support, we're not just reading around here 💅).

---

✨ NAME ✨

fuse-zip — a FUSE filesystem for zip archives with write support 🦋

---

✨ SYNOPSIS ✨

fuse-zip [options] zip-file mount-point

that's it. that's the whole vibe. zip file goes in, mount point comes out 🎀

---

✨ OPTIONS ✨

• -h — prints help. she's helpful like that 💁‍♀️
• -V — prints the version. gotta know what era of slay you're running ✨
• -r — opens the archive in read-only mode. look, don't touch 🔒
• -o opt[,opt...] — mount options, and for the details you gotta refer to mount.fuse(8) 👀
• -f — don't detach from the terminal. she stays, she clings, she's emotionally available 🫶
• -d — turns on debugging, and lowkey it also implies -f. so you get both, no cap 🐛

🌸 Specific mount options: 🌸

• force_precise_time — okay so by default, high precision timestamps only get saved to the archive for new files or files with a known creation time. if you wanna force that high-precision time saving, you pass -o force_precise_time. and in that case? the creation time will be equal to the first known file modification time. periodt ⏰

---

✨ DESCRIPTION ✨

fuse-zip is a FUSE filesystem that lets literally any program work with a ZIP archive as though it's a plain old directory. and unlike KIO or Gnome VFS, it works in any application without you having to modify a single thing. no patches, no hacks, just vibes 🦋

and here's the flex: unlike other FUSE filesystems, only fuse-zip provides write support to ZIP archives. also she's faster than all known implementations on large archives with many files. main character energy fr fr 👑

since version 0.3.0, fuse-zip supports absolute and parent-relative paths in file names — but only in read-only mode (that's the -r command line switch, bestie). absolute paths show up under the "ROOT" directory, every ".." in a path gets replaced by "UP" in the directory name, and "normal" files are placed under the "CUR" directory. it's giving organized chaos 🗂️

support for UNIX file permissions and owner information got added in version 0.4.0. peep the PERMISSIONS section for the deets 💜

since version 0.5.0, fuse-zip forces open in read-only mode if the archive file or its parent directory isn't writable. she protects herself, we love a boundaries queen 🔒

file and archive comments have been supported since version 0.7.0 💬 to read or modify a file comment, use the extended attribute "user.comment". the archive comment is accessible via the mount point's extended attribute. cute, right?

if you wanna specify character set conversion for file names in the archive, use these fusermount options:

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

see the FUSE documentation for details, iykyk 📖

---

✨ USAGE ✨

general usage looks like this:

1   mkdir /tmp/zipArchive
2   fuse-zip foobar.zip /tmp/zipArchive
3   (do something with the mounted file system)
4   fusermount -u /tmp/zipArchive

be patient bestie 😭 wait for the fuse-zip process to finish after unmounting, especially on big archives. she needs a minute to wrap up, okay?

---

✨ PERMISSIONS ✨

access check will not be performed unless the -o default_permissions mount option is given. that's it. that's the whole rule 🌈

---

✨ FILES ✨

• /var/log/user.log — check this file in case any errors occur. it's the group chat where the drama gets logged 🙈

---

✨ SEE ALSO ✨

fusermount(1), mount.fuse(8).

---

✨ LICENSE ✨

this is Free Software 🫶 this software is licensed under the GPL version 3, as published by the Free Software Foundation, or later. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. so like... she's free, she's open, she's not legally responsible for your chaos 💀

---

✨ AUTHORS ✨

Alexander Galanin <al@galanin.nnov.ru> http://galanin.nnov.ru/~al

this manual page was originally written by Kirill Zaitsev <teferiincub@gmail.com>. updated by Alexander Galanin. absolute legends, we stan 👑

---

and that's the whole page bestie ✨ this little manual came from July 2019, and the footer said the source/version line was FUSE filesystem to read and mod… with fuse-zip(1) riding along — so there you go, that's your sign-off 🎀 go mount something and slay 💅💖