After cloning, navigate to the folder on the computer. You'll see the repository folder structure with all of the files.

After the script runs, you'll see a list of matched subparts and the location of the generated SVG files print out.

If you navigate to the /Fritzing_Test folder, you'll see two new folders have been generated: /params and /parts. The /params folder contains the parameters file for generating the Fritzing part. The /parts folder contains all of the SVG files that will eventually be compiled into a Fritzing part.

Navigate to the parameters file. It is located in /Fritzing_Test/params. You can open the file in a text editor.

Here is how the breadboard view for the VCNL4030 came through. You'll notice that all of the passive components and the STEMMA QT connectors are there. These are all sourced from the /subparts directory, which has a ton of component SVG parts that are identified and placed when the kicad2fritzing script runs. These parts were carried over from the eagle2fritzing tool.

Most notably absent though is the VCNL4030 component in the center. This is expected since it isn't a standard footprint component and wouldn't be found in the /subparts directory. This is where you can flex your vector art skills.

Before starting from scratch though, you'll want to look at the Components file located in the /Graphics folder. That file contains a bunch of extra SVG component parts that you can often build on top of or even use as-is.

If you look at the top center of the Components file, you'll find a VCNL4030 vector component that you can drop into the breadboard view. This component happens to exist because a Fritzing part was previously made for the VCNL4030 with eagle2fritzing.

The last step for the breadboard view SVG is to change the Artboard boundary box to include the STEMMA QT signal circles that are outside of the board dimension. If you don't do this, then they will not be visible in Fritzing.

Then you can save the updated SVG file with these settings. The screenshot is from Adobe Illustrator, but comparable settings can be selected in Inkscape.

The schematic view SVG can usually be left as-is. The labels are all brought in as text elements so you can easily edit them.

The PCB SVG renders the board outline, pads and drills.

Now you're ready to bring the part into Fritzing. To do this, you'll copy the /parts folder from /Fritzing_Test into your Documents/Fritzing folder that the Fritzing app creates after its installed:

You should see a message pop up that the swapping mechanism is disabled for the part name that you just created, in this case the VCNL4030. Click OK. Fritzing will continue to open.

After Fritzing finishes launching, click on the Breadboard tab. Then, under Parts, search for your part name. You should see it appear in the results.

Right-click on the part and select Edit Part. This will bring you into the Fritzing part editor.

Each part view has a page where it can be edited. The first is the Breadboard view. Fritzing uses gender markings for the Breadboard connectors. You'll need to define which connectors are male and which are female. A general rule is that any pin that you would expect to plug into a breadboard should be a male type and others should be female or Pad types.

You can also redefine the graphic assigned to different connectors. For the STEMMA QT port signals, the connector is on the pad graphic by default. If you select one of the connectors, you can click Select graphic and then click on any part of the SVG graphic to change its location. In this case, you can move the GND signal from the pad to the black circle graphic.

In the schematic view, the main item to edit is each connector's terminal point. These points define where a signal originates in the schematic view:

• connectors at the top use N
• connectors at the bottom use S
• connectors on the right use E
• connectors on the left use W

For example, the INT connector would use W as its terminal point and all GND connectors would use S.

The Metadata tab is where you can edit the info for the part. The Title and Label are how the Fritzing part file will show up in search. For Adafruit parts, the Description includes the product copy and the URL is the Adafruit shop URL. Family is the type of board and part number includes a # followed by the product ID.

When you're satisfied with your edits, you'll go to File - Save as new part

You'll be prompted to change the part prefix, which is usually the manufacturer of the part followed by a dash. After updating, click OK.

This brings you back to the main Fritzing screen. Search for your part again. Now you'll see two results. The first is the original import with no edits and the second is the part with all of the edits you just made. If you hover over the part, you'll see all the metadata show up in the preview screen.

Drag and drop the part onto the breadboard. You should see the breadboard rows highlight with the connections from the GPIO. You should also be able to run wires to the STEMMA QT circle graphics.

To save your part as a packaged .FZPZ Fritzing part, right-click on the part and select Export Part...

You'll be prompted to save the file. When you're ready, click Save.

And that's how you can convert KiCad PCB files to Fritzing parts!