How to get list of all footprints using KiCAD pcbnew plugin Python API
When using KiCAD’s Python API for pcbnew
, you can obtain a list of FOOTPRINT
objects using
board: pcbnew.BOARD = pcbnew.GetBoard()
footprints: list[pcbnew.FOOTPRINT] = board.GetFootprints()
The : pcbnew.BOARD
and : list[pcbnew.FOOTPRINT]
are optional but will tell your editor (such as visual studio code) which object to expect for better autocompletion.
Complete plugin example:
#!/usr/bin/env python
import pcbnew
import os
class SimplePlugin(pcbnew.ActionPlugin):
def defaults(self):
self.name = "Plugin Name as shown in Pcbnew: Tools->External Plugins"
self.category = "A descriptive category name"
self.description = "A description of the plugin and what it does"
self.show_toolbar_button = False # Optional, defaults to False
self.icon_file_name = os.path.join(os.path.dirname(__file__), 'simple_plugin.png') # Optional, defaults to ""
def Run(self):
board: pcbnew.BOARD = pcbnew.GetBoard()
footprints: list[pcbnew.FOOTPRINT] = board.GetFootprints()
# TODO Do something useful with [board]
for footprint in footprints:
print(footprint)
SimplePlugin().register() # Instantiate and register to Pcbnew