ungoogled-software/ungoogled-chromium · error · EnvironmentError

" " for 7-zip is only available on Windows

Error message

"%s" for 7-zip is only available on Windows

What it means

extract_with_7z raises EnvironmentError when the configured 7-zip extractor command is USE_REGISTRY (auto-discover via Windows registry) but the running platform is not Windows, since registry lookup only exists there. The configuration is simply invalid for the current OS.

Solutions

1. Override the extractor on non-Windows: extractors={ExtractorEnum.SEVENZIP: '/usr/bin/7z'}
2. Only use registry-based discovery on Windows; branch on get_running_platform()
3. Install 7-zip/7za and pass its command path explicitly
4. Use extract_tar_file with the tar extractor on Unix systems

Example fix

// before
extract_with_7z(archive, out)  # DEFAULT_EXTRACTORS uses USE_REGISTRY -> fails on Linux
// after
extract_with_7z(archive, out, extractors={ExtractorEnum.SEVENZIP: '7z'})

from utils.platform import get_running_platform
from utils.platform_enum import PlatformEnum
from utils.enum import ExtractorEnum
from utils.const import USE_REGISTRY
extractors = {ExtractorEnum.SEVENZIP: '7z'}
if get_running_platform() == PlatformEnum.WINDOWS:
    extractors[ExtractorEnum.SEVENZIP] = USE_REGISTRY

def registry_ok(extractors, platform):
    return not any(v == USE_REGISTRY for v in extractors.values()) or platform == PlatformEnum.WINDOWS

try:
    extract_with_7z(archive, out, relative_to=rel)
except EnvironmentError:
    extractors = {ExtractorEnum.SEVENZIP: shutil.which('7z') or '7z'}
    extract_with_7z(archive, out, relative_to=rel, extractors=extractors)

When it happens

Trigger: Using the default DEFAULT_EXTRACTORS (which set 7-zip to registry discovery) on Linux/macOS, or explicitly passing extractors={ExtractorEnum.SEVENZIP: USE_REGISTRY} off Windows.

Common situations: Same config shared across Windows dev machines and Linux CI, or library defaults applied on non-Windows without overriding the 7-zip path.

Related errors

• " " for WinRAR is only available on Windows
• NotImplementedError

AI-assisted analysis of ungoogled-software/ungoogled-chromium@f85e84a480 (2026-08-29). Data as JSON: /api/errors/07026dbd51922356. Report an issue: GitHub.

Appendix: source

Thrown at utils/_extraction.py:262

    Only supports archives with one layer of unpacking, so compressed tar archives don't work.

    archive_path is the pathlib.Path to the archive to unpack
    output_dir is a pathlib.Path to the directory to unpack. It must already exist.

    relative_to is a pathlib.Path for directories that should be stripped relative to the
    root of the archive.
    extractors is a dictionary of PlatformEnum to a command or path to the
    extractor binary. Defaults to 'tar' for tar, and '_use_registry' for 7-Zip.
    """
    # TODO: It would be nice to extend this to support arbitrary standard IO chaining of 7z
    # instances, so _extract_tar_with_7z and other future formats could use this.
    if extractors is None:
        extractors = DEFAULT_EXTRACTORS
    sevenzip_cmd = extractors.get(ExtractorEnum.SEVENZIP)
    if sevenzip_cmd == USE_REGISTRY:
        if not get_running_platform() == PlatformEnum.WINDOWS:
            get_logger().error('"%s" for 7-zip is only available on Windows', sevenzip_cmd)
            raise EnvironmentError()
        sevenzip_cmd = str(_find_7z_by_registry())
    sevenzip_bin = _find_extractor_by_cmd(sevenzip_cmd)

    if not relative_to is None and (output_dir / relative_to).exists():
        get_logger().error('Temporary unpacking directory already exists: %s',
                           output_dir / relative_to)
        raise FileExistsError()
    cmd = (sevenzip_bin, 'x', str(archive_path), '-aoa', f'-o{str(output_dir)}')
    get_logger().debug('7z command line: %s', ' '.join(cmd))

    result = subprocess.run(cmd, check=False)
    if result.returncode != 0:
        get_logger().error('7z command returned %s', result.returncode)
        raise ChildProcessError()

    _process_relative_to(output_dir, relative_to)

View on GitHub (pinned to f85e84a480)