Version 1.2.0 built on 2025-08-16
Feature
- Add optional hidden folder control interface
<mount point>/.ratarmount-control/
. - Add capability to mount into relative subpaths in existing FUSE mount using the control interface.
- Use
rich
for help formatting, logging, and the progress bar if installed. - Enable
mfusepy
and other backend debug output for high--debug
settings. --recursive
will now also join split files and descend into the resulting file.- Add
--no-file-versions
for disabling the file version layer.
One fewer layer may improve performance and reduce problems. - Offer
--no-xxx
variants for all bool flags. - Move all command line options that are actually subcommands into an exclusive group.
Performance
- Store gzip indexes as compressed gztool index. Gztool indexes are compressed.
A novel sparsing method is used to increase compressibility by doing a sparsity analysis
and setting all unneeded window bytes to 0. This reduces the index size for large gzips by 10-20x.
This also reduces memory consumption because the gzip index is fully held in memory.
API
- Drop support for EOL Python 3.7 and 3.8. Older ratarmount versions are still available on old Python versions.
ratarmountcore
Fixes
- Make fsspec
ratar://
protocol implementation return full paths onls
so thatAbstractFileSystem.find
works.
AppImages
The AppImages can be downloaded, made executable with chmod u+x *.AppImage
, and executed directly to start ratarmount.
There are also usability helpers for AppImages such as AppImageLauncher and AM.
If the AppImage is too slow to start up or to reduce memory overhead for the AppImage itself, the AppImage can also be manually unpacked and installed:
- Extract with
ratarmount-*.AppImage --appimage-extract
- The extracted AppImage can be started by executing
squashfs-root/AppRun
. - Rename and move the resulting generic
squashfs-root
folder wherever you want, e.g.,/opt/ratarmount-<version>
. - Add a link to
/opt/ratarmount-<version>/AppRun
into some folder that is in yourPATH
variable, e.g., with:
ln -s /opt/ratarmount-<version>/AppRun ~/.local/bin/ratarmount
Slim Version
Supports: 7z, ASAR, bzip2, EXT4, FAT, gzip, RAR, SQLAR, TAR, XZ, ZIP, zlib, ZStandard
Normal / Full Version
Supports:
- All slim formats
- libarchive backend: ar, CAB, cpio, grzip, ISO9660, lrzip, LZ4, lzip, LZMA, lzop, RPM, UU, WARC, XAR, Z
- SquashFS
- All remote protocols: ftp://, git://, http://, ssh://, ...
- Colored output
- Ships with compiled Python bytecode to speed up startup latency by 2-3x at the cost of 20% larger AppImage size.