Archive import
Extract and organize ZIP, TGZ and TAR.GZ archives in a safe staging folder.
Public release: Mouzi v0.1.5. Features planned for a later version are labelled on the page.
Archive import was designed for exports such as Google Takeout, but it works with any supported .zip, .tgz or .tar.gz file.
What import does
- Mouzi creates a unique staging folder in its cache.
- It extracts files from the archive and flattens the archive’s directory structure.
- Duplicate names become
name (1).ext,name (2).extand so on. - It applies your current global rules to the extracted files.
- It shows a summary and lets you open the staging folder.
The original archive is not changed or deleted.
Where files end up
Relative destinations are created inside the staging folder. Absolute rule destinations still point to their configured paths outside the cache. Files that match no rule remain at the top level of the staging folder.
This means you should review absolute destinations before importing a large archive.
Safety behavior
Mouzi rejects unsafe archive paths that try to escape the staging folder. It extracts files, not the archive’s original empty directory tree.
Archive import uses current rules immediately. It is separate from watched-folder modes, so setting Downloads to Manual does not turn an import into a preview.
Staging locations
Windows:
%LOCALAPPDATA%\mouzi\mouzi\cache\archive-importsLinux:
$XDG_CACHE_HOME/mouzi/archive-importsThe Linux default is normally ~/.cache/mouzi/archive-imports.
After verifying the organized result, move it to permanent storage or remove the staging folder yourself. Mouzi does not automatically delete imported data.