{"id":16361726,"url":"https://github.com/bennymeg/fabrication-toolkit","last_synced_at":"2025-05-16T01:06:24.219Z","repository":{"id":38972006,"uuid":"499213926","full_name":"bennymeg/Fabrication-Toolkit","owner":"bennymeg","description":"An JLC PCB Fabrication Plugin for KiCad ","archived":false,"fork":false,"pushed_at":"2025-04-30T16:35:44.000Z","size":1246,"stargazers_count":439,"open_issues_count":11,"forks_count":68,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-05-12T17:04:01.067Z","etag":null,"topics":["eda","fabrication","jlc","jlcpcb","kicad","lcsc","pcb","pcba","plugin","toolkit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bennymeg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"bennymeg","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-06-02T16:40:46.000Z","updated_at":"2025-05-12T13:10:09.000Z","dependencies_parsed_at":"2023-02-16T23:30:52.075Z","dependency_job_id":"ca5cf528-6522-4109-b7cb-829158ee20c5","html_url":"https://github.com/bennymeg/Fabrication-Toolkit","commit_stats":null,"previous_names":["bennymeg/fabrication-toolkit","bennymeg/jlc-plugin-for-kicad"],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bennymeg%2FFabrication-Toolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bennymeg%2FFabrication-Toolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bennymeg%2FFabrication-Toolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bennymeg%2FFabrication-Toolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bennymeg","download_url":"https://codeload.github.com/bennymeg/Fabrication-Toolkit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254448579,"owners_count":22072764,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["eda","fabrication","jlc","jlcpcb","kicad","lcsc","pcb","pcba","plugin","toolkit"],"created_at":"2024-10-11T02:14:38.901Z","updated_at":"2025-05-16T01:06:19.209Z","avatar_url":"https://github.com/bennymeg.png","language":"Python","funding_links":["https://github.com/sponsors/bennymeg"],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/assets/logo.svg?raw=true\" \n    style=\"display:block margin-left: auto; margin-right: auto;\" alt=\"JLC PCB Plug-in for KiCad\"\u003e\n    \n\u003cdiv align=\"center\"\u003e\n\n| **JLC PCB Plug-in for KiCad** |\n|:-----:|\n\n[![Sponsor](https://img.shields.io/static/v1?label=Sponsor\u0026message=%E2%9D%A4\u0026logo=GitHub\u0026color=%23fe8e86)](https://github.com/sponsors/bennymeg)\n\n\u003c/div\u003e\n\n## Features\n1.\tGenerates gerber files in correct format for production\n2.\tGenerates BOM file in correct format for production\n3.\tGenerates Pick and Place file in correct format for assembly\n4.\tGenerates IPC netlist file\n\n## Installation\n\n### Official Installation\nFabrication Toolkit is distributed with the official releases of KiCad 6+. Open the \"Plugin and Content Manager\" from the KiCad main menu and install the \"\u003cins\u003eFabrication Toolkit\u003c/ins\u003e\" plugin from the selection list.\n\n\u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/assets/manager.png?raw=true\" height=275\u003e\n\n### Manual installation\nDownload the [latest release](https://github.com/bennymeg/JLC-Plugin-for-KiCad/releases) ZIP file. Open the \"Plugin and Content Manager\" from the KiCads main window and install the ZIP file via \"Install from File\".\n\n## Usage\nClick on the Fabrication Toolkit \u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/resources/icon.png?raw=true\" style=\"margin-bottom: 8px;\" alt=\"Logo\" height=24\u003e button on the top tool box inside KiCad pcb editor (pcbnew).\n\n**⊛** Ensure your board is synchronized before invoking this addon [**F8**].\n\n**⊛** The `User_1` layer in internally defined as a **V-Cuts** layer, please avoid using it for anything else (unless disabled). \u003cspan style=\"text-color: light-grey !important;\"\u003e_(since v3.0.0)_.\u003c/span\u003e\n\n## Options\n\nOptions can be set in the dialog that appears when the plugin is invoked. They are saved in a file called `fabrication-toolkit-options.json` in the project directory so that they are remembered between invocations of the plugin.\n\n\u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/assets/options.png?raw=true\" height=275\u003e\n\n☑ __Archive name__: Name of the archive file to be generated. Can include text variables, such as e.g. `${TITLE}_${REVISION}`\u003c/br\u003e\n☑ __Additional layers__: Comma-separated list of additional layers to include in the gerber archive.\u003c/br\u003e\n☑ __Plot all active layers__: Whether to include all layers, instead of just the layers required by JLCPCB.\u003c/br\u003e\n☑ __Set User.1 as V-Cut layer__: Merge User.1 layer with the Edge-Cut layer in production.\u003c/br\u003e\n☑ __Use User.2 for an alternative Edge-Cut layer__: Use the User.2 instead of the Edge-Cut layer for the board outline in production. This is useful if you need process edges or panelization during production but still want to keep the individual outline for prototyping, 3D model exports, or similar purposes.\u003c/br\u003e\n☑ __Apply automatic translations__: Apply known translation fixes for common components.\u003c/br\u003e\n☑ __Apply automatic fill for all zones__: Refill all zones before generation production files.\u003c/br\u003e\n☑ __Exclude DNP components from BOM__: Exclude components the had been set a DNP from th BOM.\u003c/br\u003e\n\n### ① Include Component Part Number in Production Files\nAdd an 'LCSC Part #'* field with the LCSC component part number to the symbol's fields property.\n\n\u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/assets/mpn.png?raw=true\" height=420\u003e\n\n#### Primary Fields*:\n| 'LCSC Part #' | 'LCSC Part' | 'LCSC PN' | 'LCSC P/N' | 'LCSC Part No.' | 'JLCPCB Part #' | 'JLCPCB Part' | 'JLCPCB PN' | 'JLCPCB P/N' | 'JLCPCB Part No.' |\n| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |\n\n_The fields will be query in the order denoted above._\n\n#### Fallback Fields*:\n| 'LCSC' | 'JLC' | 'MPN' | 'Mpn' | 'mpn' |\n| --- | --- | --- | --- | --- |\n\n_The fields will be query in the order denoted above._\n\n---\n\n### ② Ignore Footprint in Production Files\nSelect 'Exclude from board' or 'Exclude from BOM' in the symbol's attributes property in order to ignore the footprint from the relevant file.\n\n\u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/assets/attributes.png?raw=true\" height=420\u003e\n\nSelect 'Exclude from position files' or 'Exclude from BOM' in the footprint's fabrication attributes property in order to ignore the footprint from the relevant file.\n\n\u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/assets/fabrication.png?raw=true\" height=505\u003e\n\n---\n\n### ③ Offset Component Rotation\nThe rotation of components in KiCad Footprints does not always match the orientation in the JLC library because KiCad and JLC PCB used different variation of the same standard. Most of the rotations may be corrected by the `rotations.cf` definitions. To the exception cases: add an 'FT Rotation Offset'* field - with positive values indicating counter-clockwise orientation offset in degrees.\n\n\u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/assets/rotation-jlc.png?raw=true\" height=164\u003e\n\nIf the JLC preview shows a footprint like this, enter a rotation offset of -90 to rotate pin 1 to the lower right corner.\n\n\u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/assets/rotation.png?raw=true\" height=420\u003e\n\nAs the rotation offset is entered in the Schematic Editor, make sure to update your PCB with the changes made to the schematic before generating a new set of production files, otherwise your changes won't be reflected.\n\n#### Primary Fields*:\n| 'FT Rotation Offset' |\n| --- |\n\n_The fields will be queried in the order denoted above._\n\n#### Fallback Fields*:\n| 'Rotation Offset' | 'RotOffset' |\n| --- | --- |\n\n_The fields will be queried in the order denoted above._\n\n---\n\n### ④ Offset Component Position\nThe position of components in KiCad Footprints does not always match the orientation in the JLC library because KiCad and JLCPCB used different variation of the same standard. To the exception cases: add an 'FT Position Offset'* field with an comma separated x,y position offset to correct it. \n\nUse following table to quickly find out to which coordinate enter the correction based on JLC arrows clicks - depending on footprint rotation in KiCad PCB Editor status bar:\n|KiCad footprint deg | x | y|\n|----|----|----|\n|0 deg, Front | right arrow | up arrow |\n|0 deg, Back | left arrow | down arrow |\n|180 deg, Front | left arrow | down arrow |\n|180 deg, Back | right arrow | up arrow |\n|90 deg, Front or Back | up arrow | left arrow |\n|-90 deg, Front or Back | down arrow | right arrow |\n\nFor custom angles it's best to place also a temporary straight symbol to perform alignment.\nSingle arrow press in JLC is 0.0635mm (= 1/400in) shift.\n\n\u003cimg src=\"https://github.com/bennymeg/JLC-Plugin-for-KiCad/blob/master/assets/position.png?raw=true\" height=420\u003e\n\nAs the position offset is entered in the Schematic Editor, make sure to update your PCB with the changes made to the schematic before generating a new set of production files, otherwise your changes won't be reflected.\n\n#### Primary Fields*:\n| 'FT Position Offset' |\n| --- |\n\n_The fields will be queried in the order denoted above._\n\n#### Fallback Fields*:\n| 'Position Offset' | 'PosOffset' |\n| --- | --- |\n\n_The fields will be queried in the order denoted above._\n\n### ⑤ Override Component Origin\nThe Fabrication Toolkit reports the position of each component based on an automatically selected point of reference. This default behavior can be overridden by adding an 'FT Origin'* field to the component. \n\n#### Primary Fields*:\n| 'FT Origin' |\n| --- |\n\n_The fields will be queried in the order denoted above._\n\n#### Fallback Fields*:\n| 'Origin' |\n| --- |\n\nThe **Origin** field supports the following values:\n\n- `Anchor` - Uses the footprint's anchor point, which can be modified in KiCad's footprint editor.\n- `Center` - Uses the center of the bounding box formed by the footprint's pads.\n\n### ⑥ Override Component Layer\nSome footprints may have their components defined on the opposite layer to there actual footprints. In these instances you can override mount side by adding an 'FT Layer Override'* field to the component.\n\nThe **Layer Override** field supports the following values:\n- `top`, `t` - Override footprint layer to the top.\n- `bottom`, `b` - Override footprint layer to the bottom.\n\n#### Primary Fields*:\n| 'FT Layer Override' |\n| --- |\n\n_The fields will be queried in the order denoted above._\n\n#### Fallback Fields*:\n| 'Layer Override' | 'LayerOverride' |\n| --- | --- |\n\n_The fields will be queried in the order denoted above._\n\n\n## CLI\nThe plugin can also be used via the linux command line. This can be particularly useful if you need to embed the plugin into an automation pipeline or environment.\nThe plugin can be called with the command below:\n```\npython3 -m plugins.cli -p /myProject/myBoard.kicad_pcb\n```\n\nAll the options from the GUI are also available via the cli interface:\n```\npython3 -m plugins.cli -h\n\nusage: Fabrication Toolkit [-h] --path PATH [--additionalLayers LAYERS] [--user1VCut] [--user2AltVCut]\n                           [--autoTranslate] [--autoFill] [--excludeDNP] [--allActiveLayers] [--archiveName NAME]\n                           [--openBrowser]\n\nGenerates JLCPCB production files from a KiCAD board file\n\noptions:\n  -h, --help            show this help message and exit\n  --path PATH, -p PATH  Path to KiCAD board file\n  --additionalLayers LAYERS, -aL LAYERS\n                        Additional layers(comma-separated)\n  --user1VCut, -u1      Set User.1 as V-Cut layer\n  --user2AltVCut, -u2   Use User.2 for alternative Edge-Cut layer\n  --autoTranslate, -t   Apply automatic position/rotation translations\n  --autoFill, -f        Apply automatic fill for all zones\n  --excludeDNP, -e      Exclude DNP components from BOM\n  --allActiveLayers, -aaL\n                        Export all active layers instead of only commonly used ones\n  --archiveName NAME, -aN NAME\n                        Name of the generated archives\n  --openBrowser, -b     Open web browser with directory file overview after generation\n```\n\n\n## Author\n\nBenny Megidish\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbennymeg%2Ffabrication-toolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbennymeg%2Ffabrication-toolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbennymeg%2Ffabrication-toolkit/lists"}