Tool manager failing to install ESP32 Arduino Lib Builder

Development Platforms
,
1

Hi there.

It’s my first time reopening PlatformIO in a couple of months, and this is the first time I’ve run into such a show stopping issue. After opening a new project with a Seeed XIAO ESP32-C6, I ran into a lengthy error (output is below). I opened the same project on my other computer, same error. I tried deleted my .platformio folder and reinstalling the PlatformIO extension on VSCode, same issue. I opened old projects which were known to work, with boards such as the Seeed XIAO ESP32-S3, freenove ESP32-S3 wroom, and the esp32-s3 n16r8, same error.

This error always pops up when I build the project and the tool manager tries to install the ESP32 Arduino Lib Builder. I couldn’t find something exactly like this on other forum posts, so if anyone has seen this issue before, I would appreciate your guidance! Thank you.

Tool Manager: Installing https://github.com/espressif/esp32-arduino-lib-builder/releases/download/idf-release_v5.5/esp32-arduino-libs-idf-release_v5.5-b774170f-v1.zip
Unpacking  [#-----------------------------------]    3%  00:01:19
Unpacking...
FileNotFoundError: Traceback (most recent call last):
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\manager\_install.py", line 37, in unpack
    return fu.unpack(dst, with_progress=with_progress)
           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\unpack.py", line 201, in unpack
    self._archiver.extract_item(item, dest_dir)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\unpack.py", line 49, in extract_item
    self._afo.extract(item, dest_dir)
    ~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^
  File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.13_3.13.3824.0_x64__qbz5n2kfra8p0\Lib\zipfile\__init__.py", line 1789, in extract
    return self._extract_member(member, path, pwd)
           ~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^
  File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.13_3.13.3824.0_x64__qbz5n2kfra8p0\Lib\zipfile\__init__.py", line 1878, in _extract_member
    open(targetpath, "wb") as target:
    ~~~~^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: 'C:\\Users\\mjkuo\\.platformio\\.cache\\tmp\\pkg-installing-dofgsswz\\esp32-arduino-libs\\esp32c6\\include\\espressif__esp_matter\\connectedhomeip\\connectedhomeip\\src\\app\\clusters\\camera-av-settings-user-level-management-server\\camera-av-settings-user-level-management-server.h'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\__main__.py", line 103, in main
    cli()  # pylint: disable=no-value-for-parameter
    ~~~^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\click\core.py", line 1569, in __call__
    return self.main(*args, **kwargs)
           ~~~~~~~~~^^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\click\core.py", line 1490, in main
    rv = self.invoke(ctx)
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\cli.py", line 85, in invoke
    return super().invoke(ctx)
           ~~~~~~~~~~~~~~^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\click\core.py", line 1970, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
                           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\click\core.py", line 1353, in invoke
    return ctx.invoke(self.callback, **ctx.params)
           ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\click\core.py", line 907, in invoke
    return callback(*args, **kwargs)
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\click\decorators.py", line 34, in new_func
    return f(get_current_context(), *args, **kwargs)
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\run\cli.py", line 147, in cli
    process_env(
    ~~~~~~~~~~~^
        ctx,
        ^^^^
    ...<9 lines>...
        verbose,
        ^^^^^^^^
    )
    ^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\run\cli.py", line 210, in process_env
    ).process()
      ~~~~~~~^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\run\processor.py", line 81, in process
    install_project_env_dependencies(
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
        self.name,
        ^^^^^^^^^^
    ...<3 lines>...
        },
        ^^
    )
    ^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\commands\install.py", line 132, in install_project_env_dependencies
    _install_project_env_platform(project_env, options),
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\commands\install.py", line 149, in _install_project_env_platform
    PlatformPackageManager().install(
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
        spec,
        ^^^^^
    ...<3 lines>...
        force=options.get("force"),
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\manager\platform.py", line 62, in install
    p.install_required_packages(force=force)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\platform\_packages.py", line 76, in install_required_packages
    self.install_package(name, force=force)
    ~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\platform\_packages.py", line 70, in install_package
    return self.pm.install(spec or self.get_package_spec(name), force=force)
           ~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\manager\_install.py", line 47, in install
    pkg = self._install(spec, skip_dependencies=skip_dependencies, force=force)
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\manager\_install.py", line 97, in _install
    pkg = self.install_from_uri(spec.uri, spec)
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\manager\_install.py", line 191, in install_from_uri
    self.unpack(dl_path, tmp_dir)
    ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\manager\_install.py", line 42, in unpack
    return fu.unpack(dst, with_progress=False)
           ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\unpack.py", line 179, in unpack
    self._archiver.extract_item(item, dest_dir)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^
  File "C:\Users\mjkuo\.platformio\penv\Lib\site-packages\platformio\package\unpack.py", line 49, in extract_item
    self._afo.extract(item, dest_dir)
    ~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^
  File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.13_3.13.3824.0_x64__qbz5n2kfra8p0\Lib\zipfile\__init__.py", line 1789, in extract
    return self._extract_member(member, path, pwd)
           ~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^
  File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.13_3.13.3824.0_x64__qbz5n2kfra8p0\Lib\zipfile\__init__.py", line 1878, in _extract_member
    open(targetpath, "wb") as target:
    ~~~~^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: 'C:\\Users\\mjkuo\\.platformio\\.cache\\tmp\\pkg-installing-dofgsswz\\esp32-arduino-libs\\esp32c6\\include\\espressif__esp_matter\\connectedhomeip\\connectedhomeip\\src\\app\\clusters\\camera-av-settings-user-level-management-server\\camera-av-settings-user-level-management-server.h'

============================================================

An unexpected error occurred. Further steps:

* Verify that you have the latest version of PlatformIO using
  `python -m pip install -U platformio` command

* Try to find answer in FAQ Troubleshooting section
  https://docs.platformio.org/page/faq/index.html

* Report this problem to the developers
  https://github.com/platformio/platformio-core/issues

============================================================
2

That path is extremely long. This only works if you turn on Win32 NTFS Long Paths. Sadly the code to display a warning about that only runs after the packages were extracted (?) so you can’t see it when it fails in the unpack stage.

You can also use the instructions from https://arduino-pico.readthedocs.io/en/latest/platformio.html#important-steps-for-windows-users-before-installing.

Do those old projects explicitly use

platform = espressif32@<some version>

? If not, they are not correctly versioned. Once you open a project that uses the PIOArduino core (because it needs the newer Arduino core or something), it becomes the latest espressif32 version. So, projects using just platform = espressif32 suddenly compile against PIOArduino with a much more recent core, usually failing to compile. Use explicit versions from https://github.com/platformio/platform-espressif32/releases, e.g.,

platform = espressif32@7.0.1

You can also roughly use the date of the project (or the last modification date of a file inside it) to correlate it with the needed espressif32 platform version, see e.g. https://github.com/platformio/platform-espressif32/tags.

3

Thank you! Enabling long paths fixed the problem. Setting the platform version was not the issue on the older projects, as they also suffered from the long path error.