https://github.com/bzf/archivefs
Mount your archives and browse them as regular files
https://github.com/bzf/archivefs
fuse-filesystem libarchive osxfuse rust-lang
Last synced: 3 months ago
JSON representation
Mount your archives and browse them as regular files
- Host: GitHub
- URL: https://github.com/bzf/archivefs
- Owner: bzf
- Created: 2016-07-23T16:23:48.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2021-02-02T11:14:05.000Z (over 4 years ago)
- Last Synced: 2025-04-09T17:14:29.629Z (3 months ago)
- Topics: fuse-filesystem, libarchive, osxfuse, rust-lang
- Language: Rust
- Homepage:
- Size: 111 KB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# archivefs
`archivefs` - mount your archives and browse them as regular files
## Usage
```man
archivefs [-sdf] --directory=/some/absolute/path /mountpoint
```
## Features
* Expand archives as directories
* Reads files from an archive as a regular file
* Shows non-archive files and directories as normal
## Quick example
```sh
$ tree .
.
├── archives
│ └── maskinen.tar.gz
└── mountpoint
2 directories, 1 file
$ archivefs --directory=$HOME/example/archives mountpoint/
$ tree .
.
├── archives
│ └── maskinen.tar.gz
└── mountpoint
└── maskinen
├── pengar.txt
└── segertaget.txt
3 directories, 3 files
$ cat mountpoint/maskinen/segertaget.txt | head -n5
[Vers 1]
He-he-hej, här kommer segertåget
Rullar in som teknodromen
Tryck på play, du sätter på den
Dansar som på, äh, vi kör igen
```
## Description
`archivefs` is a FUSE file system for mounting and reading from archive files
instead of unpacking them to read the content.
## Building
To build `archivefs` there are some packages that are required to be
installed on the system:
* [libfuse](https://github.com/libfuse/libfuse) (or [osxfuse](https://github.com/osxfuse/osxfuse))
* [libarchive](https://github.com/libarchive/libarchive)
* [Rust](https://www.rustup.rs/)
* A C compiler
* Homebrew
To build the project you run the `make` command:
```sh
$ brew bundle # Installs dependencies for building the project
$ make
```
## Bugs
`archivefs` does not handle nested directories inside an archive file
properly. For now only flat archvies are compatiable.
If you get the following error message you can try setting the
`LD_LIBRARY_PATH` environment variable to the path of the `libarchivefs`
library:
```
$ ./archivefs
./archivefs: error while loading shared libraries: libarchivefs.so: cannot open shared object file: No such file or directory
$ LD_LIBRARY_PATH=./target/release/deps ./archivefs
Need to set which archive you want to mount
```
## Good links
* https://fossies.org/dox/fuse-2.9.7/fuse__compat_8h_source.html