You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Checked the issue tracker for similar issues to ensure this is not a duplicate
Read the documentation to confirm the issue is not addressed there and your configuration is set correctly
Tested with the latest version to ensure the issue hasn't been fixed
How often does this bug occurs?
always
Expected behavior
Downloaded the current version and left as a .zip. When selecting the .zip file in PCM via "Install from file..." it returns: "Archive does not contain a valid metadata.json file."
After several repeated attempts, I unzipped an identical .zip file. The 'metadata.json' file is clearly in the zipped file. Perhaps something in the json file needs tweaking for KiCad 9.0 capability so it is detected?
Actual behavior (suspected bug)
When selecting the .zip file in PCM via "Install from file..." it returns: "Archive does not contain a valid metadata.json file." Thus, it is not possible to install the ESP32 KiCad library.
Error logs or terminal output
Steps to reproduce the behavior
I tried to install the current .zip file in KiCad 9.0 (Windows 11) via the PCM "Install from file..." option.
Project release version
Current release
System architecture
Intel/AMD 64-bit (modern PC, older Mac)
Operating system
Windows
Operating system version
Windowd 11
Shell
other (details in Additional context)
Additional context
I am not using a Shell. I followed the directions on this webpage:
Download current release .zip.
Did not unzip file.
Opened KiCad 9.0 PCM.
Selected: 'Install from Library..."
Selected zipped .zip file.
Could not install due to "missing" metadata.json file.
When you download this repo as zip, there is no manifest since it's in subfolder. I extracted it, modified manifest file, selected files and compressed to zip. Then I tried to import and it worked :) You can give it a try when waiting for official update metadata.json
For me, the distribution file 3.0.2 worked flawlessly for KiCAD 9.0.4 on Mac OS 15.6
All I had to do, was download as ZIP file (not auto-extract as the Mac likes to do nowadays) - worked.
Activity
jpitucha commentedon Sep 11, 2025
When you download this repo as zip, there is no manifest since it's in subfolder. I extracted it, modified manifest file, selected files and compressed to zip. Then I tried to import and it worked :) You can give it a try when waiting for official update
metadata.json
colorado1876 commentedon Sep 11, 2025
Thank-you!
sumirati commentedon Sep 26, 2025
For me, the distribution file 3.0.2 worked flawlessly for KiCAD 9.0.4 on Mac OS 15.6
All I had to do, was download as ZIP file (not auto-extract as the Mac likes to do nowadays) - worked.
Therefore I propose, closing the issue.
colorado1876 commentedon Sep 26, 2025
As reported, I am using Windows 11, not a macOS.
jpitucha commentedon Dec 30, 2025
I updated kicad_version property, in previous comment I attached modified manifest.json
belalmohamedphd2028-jpg commentedon Feb 5, 2026
Thank you so much, it is working after downloading your metadata.json file
jake-tobin commentedon Apr 1, 2026
switching out the metadata.json file didn't do it for me unfortunately