{"id":13418544,"url":"https://github.com/badgeek/svg2shenzhen","last_synced_at":"2026-01-17T01:46:18.508Z","repository":{"id":41478881,"uuid":"127214897","full_name":"badgeek/svg2shenzhen","owner":"badgeek","description":"Convert Inkscape SVG drawings to KiCad PCB and footprint modules","archived":false,"fork":false,"pushed_at":"2025-03-15T13:51:04.000Z","size":17567,"stargazers_count":829,"open_issues_count":50,"forks_count":78,"subscribers_count":35,"default_branch":"master","last_synced_at":"2025-06-09T13:43:10.793Z","etag":null,"topics":["art","badge","badgelife","inkscape","kicad-pcb","openhardware","pcb","pcb-art"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/badgeek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2018-03-29T00:33:16.000Z","updated_at":"2025-05-24T15:44:47.000Z","dependencies_parsed_at":"2025-04-10T10:49:55.514Z","dependency_job_id":"54e5f750-9a19-43c9-bfa8-b506a10af0d9","html_url":"https://github.com/badgeek/svg2shenzhen","commit_stats":null,"previous_names":["badgeek/svg2shenzhen-next"],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/badgeek/svg2shenzhen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badgeek%2Fsvg2shenzhen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badgeek%2Fsvg2shenzhen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badgeek%2Fsvg2shenzhen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badgeek%2Fsvg2shenzhen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/badgeek","download_url":"https://codeload.github.com/badgeek/svg2shenzhen/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badgeek%2Fsvg2shenzhen/sbom","scorecard":{"id":222877,"data":{"date":"2025-08-11","repo":{"name":"github.com/badgeek/svg2shenzhen","commit":"8ac233113a1ac6fd9a4599e3eeb6edf478a8903f"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.2,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":3,"reason":"Found 8/22 approved changesets -- score normalized to 3","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":3,"reason":"binaries present in source code","details":["Warn: binary detected: potrace/CMakeFiles/3.10.3/CMakeDetermineCompilerABI_C.bin:1","Warn: binary detected: potrace/CMakeFiles/3.10.3/CMakeDetermineCompilerABI_CXX.bin:1","Warn: binary detected: potrace/CMakeFiles/3.10.3/CompilerIdC/a.out:1","Warn: binary detected: potrace/CMakeFiles/3.10.3/CompilerIdCXX/a.out:1","Warn: binary detected: potrace/CMakeFiles/feature_tests.bin:1","Warn: binary detected: potrace/libpotrace.a:1","Warn: binary detected: src/bitmap2component:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact 0.2.18.7-Windows-Fix not signed: https://api.github.com/repos/badgeek/svg2shenzhen/releases/206022494","Warn: release artifact 0.2.18.7 not signed: https://api.github.com/repos/badgeek/svg2shenzhen/releases/30020322","Warn: release artifact 0.2.18.6 not signed: https://api.github.com/repos/badgeek/svg2shenzhen/releases/29896703","Warn: release artifact 0.2.18.5 not signed: https://api.github.com/repos/badgeek/svg2shenzhen/releases/29857296","Warn: release artifact 0.2.18.4 not signed: https://api.github.com/repos/badgeek/svg2shenzhen/releases/29841171","Warn: release artifact 0.2.18.7-Windows-Fix does not have provenance: https://api.github.com/repos/badgeek/svg2shenzhen/releases/206022494","Warn: release artifact 0.2.18.7 does not have provenance: https://api.github.com/repos/badgeek/svg2shenzhen/releases/30020322","Warn: release artifact 0.2.18.6 does not have provenance: https://api.github.com/repos/badgeek/svg2shenzhen/releases/29896703","Warn: release artifact 0.2.18.5 does not have provenance: https://api.github.com/repos/badgeek/svg2shenzhen/releases/29857296","Warn: release artifact 0.2.18.4 does not have provenance: https://api.github.com/repos/badgeek/svg2shenzhen/releases/29841171"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 16 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T02:59:58.610Z","repository_id":41478881,"created_at":"2025-08-17T02:59:58.611Z","updated_at":"2025-08-17T02:59:58.611Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28491632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T00:50:05.742Z","status":"ssl_error","status_checked_at":"2026-01-17T00:43:11.982Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["art","badge","badgelife","inkscape","kicad-pcb","openhardware","pcb","pcb-art"],"created_at":"2024-07-30T22:01:03.558Z","updated_at":"2026-01-17T01:46:18.500Z","avatar_url":"https://github.com/badgeek.png","language":"C++","funding_links":["https://www.patreon.com/badgeek"],"categories":["C++"],"sub_categories":[],"readme":"# Svg2Shenzhen\n\n# Sadly this project is discontinued\n\nThere are better tools to create artistic pcb here is one that i recommend: https://github.com/wntrblm/Gingerbread\n\nInkscape extension for exporting drawings into a KiCad PCB.\n\n![showcase](https://github.com/badgeek/svg2shenzhen/blob/master/doc/resources/showcase.jpeg?raw=true)\n\n## Features\n\n- Draw Any kind of shapes without restriction\n- Supports Drill Pad, and custom drill size\n- Supports Edge Cut (PCB Shape)\n- Works on OSX, Windows and Linux\n\n## Install\n\nWarning: starting from 0.2.18 svg2shenzhen only support Inkscape 1.0 and above\n\n1. Download the latest version (0.2.18.7)\n  - Windows [https://github.com/badgeek/svg2shenzhen/releases/download/0.2.18.7/svg2shenzhen-extension-0.2.18.7.zip](https://github.com/badgeek/svg2shenzhen/releases/download/0.2.18.7-Windows-Fix/svg2shenzhen-extension-0.2.18.7.zip)\n  - Linux / OSX https://github.com/badgeek/svg2shenzhen/releases/download/0.2.18.7/svg2shenzhen-extension-0.2.18.7.tar.gz\n  - Release notes: https://github.com/badgeek/svg2shenzhen/releases\n  - Older version: https://github.com/badgeek/svg2shenzhen/releases\n\n2. Extract and copy the files into the directory indicated in Inkscape under *Edit -\u003e Preferences -\u003e System: User extensions*\n\n**Step by Step Guide with Screenshot**\n  - Go to your extracted folder it should look like this\n  \n  ![windowsStep0](https://github.com/badgeek/svg2shenzhen/blob/master/doc/resources/windows_step_0.png?raw=true)\n  \n  - Copy all files *(\"svg2shenzhen\" folder + svg2shenzhen_about.inx + svg2shenzhen_export.inx + svg2shenzhen_prepare.inx)*\n  - Open Inkscape and go **Edit --\u003e Preferences**\n  \n  ![windowsStep1](https://github.com/badgeek/svg2shenzhen/blob/master/doc/resources/windows_step_1.png?raw=true)\n  \n  - Under Preferences go to **System**, Now in **System info** you will see option ***User extensions:*** this is the path of extension. You can hit on ***Open*** icon and it will open up the folder.\n  \n  ![windowsStep2](https://github.com/badgeek/svg2shenzhen/blob/master/doc/resources/windows_step_2.png?raw=true)\n  \n  - Paste all the files copied\n  \n  ![windowsStep3](https://github.com/badgeek/svg2shenzhen/blob/master/doc/resources/windows_step_3.png?raw=true)\n  \n  - **Restart Inkscape** \n\n## How to\n\nIn Inkscape:\n\n1. *Extension \u003e Svg2Shenzhen \u003e Prepare Document*\n2. Choose layer (F.Cu.. etc)\n3. Draw PCB\n4. *Extension \u003e Svg2Shenzhen \u003e Export KiCad*\n\nDownload and open [Example PCB](https://raw.githubusercontent.com/badgeek/svg2shenzhen-next/master/examples/viruspcb.svg)\n\n## Tutorials\n\n- Custom Footprints for KiCad - \u003chttps://www.gabetaubman.com/blog/posts/kicad-custom-footprint/\u003e\n- PCBArt Badge - \u003chttp://blog.sheasilverman.com/2019/01/pcbart/\u003e\n\n## Layername definitions\n\n1. After the *Prepare Document* step, only two fabrication layers are used:\n   *Edge.Cuts* and *Drill*,\n   and for the different PCB-layers, only the *F.Cu* layer is active.\n   The others have the post-fix \"-disabled\" in their layer name;\n   change this by removing this post-fix to enable more layers.\n2. Special use of the solder-mask layers *F.Mask* and *B.Mask*:\n   Due to the fabrication standard of PCB manufacturing,\n   when enabled, this will lead to the solder-mask NOT being present\n   where there are black areas in your design.\n   This is kinda PCB/KiCad standard, but can be confusing.\n   If you want to Get-What-You-See from Inkscape,\n   meaning that you really draw the color where you want the solder-mask to be,\n   change the layer name to *F.Mask-invert*\n3. Super easy simple PCB with exposed copper surrounded by solder-mask,\n   can be generated automatically by leaving the *F.Mask* layer empty\n   and renaming it to *F.Mask-auto*.\n4. Feel free to add your own layers, for testing graphics and designing stuff.\n   All these other layers will be ignored.\n\n## Tips\n\n1. For *Edge.Cut* layers, you need to convert any polygons or objects to paths with only an outline, no fill.\n   Don't use any groups on *Edge.Cut* layers,\n   and if you have paths with inner cut-outs,\n   break them apart into separate paths.\n2. For Drill layers, place circle objects,\n   and they will be converted into drill pads in KiCad with the same diameter.\n   These drills will not have annular rings,\n   unless you also add copper to the *F.Cu* and *B.Cu* layers.\n   Don't use any groups on the *Drill* layer either.\n\n## References\n\n- [Svg2Shenzhen Announcement on Gosh Community Forum](https://forum.openhardware.science/t/svg2shenzhen-save-inkscape-drawing-as-kicad-pcb/989)\n- [PCB Art with Inkscape - Developer log](http://wiki.8bitmixtape.cc/#/4_7.1-PCB-Art-with-Kicad-and-Inkscape) on the 8BitMixtape Wiki\n- [Practical Guide to Designing PCB Art](https://medium.com/@urish/a-practical-guide-to-designing-pcb-art-b5aa22926a5c)\n- [KitSprint ANORG 2018](http://wiki.sgmk-ssam.ch/wiki/KitSprint_ANORG_2018#Kicad_bitmap_import_for_Shenzhen_Ready)\n\n## Videos\n- Drawing PCBs with Inkscape (FOSSDEM) with @kasbah of kitspace - https://www.youtube.com/watch?v=xXRPw7ItMaM\n- Making a PCB Badge for Hackaday Supercon! - https://www.youtube.com/watch?v=YqdBiOj8uXw\n- Understanding and Making PCB Art (mrtwinkletwinkle) https://www.youtube.com/watch?v=Sbkvza8cKQE\n\n## Support this project\n\nThis project is developed independently and without any connection to funding or big collective or organization.\nDonation is highly appreciated.\nGo to \u003chttps://www.patreon.com/badgeek\u003e to become a patron and support this project\n\n\u003ca href=\"https://www.patreon.com/badgeek\"\u003e\n  \u003cimg src=\"https://i.imgur.com/ys5X3ZP.png\" \u003e\n\u003c/a\u003e\n\n## Contributors\n\n- Budi Prakosa [@badgeek](https://github.com/badgeek)\n- Kaspar Emanuel [@kasbah](https://github.com/kasbah)\n\n## Credits\n\n* inkscape-export-layers - \u003chttps://github.com/jespino/inkscape-export-layers\u003e\n* bitmap2component (kicad) - \u003chttps://github.com/KiCad/kicad-source-mirror/tree/master/bitmap2component\u003e\n* csv_output - \u003chttps://github.com/tbekolay/csv_output\u003e\n* svg2mod - \u003chttps://github.com/svg2mod/svg2mod\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadgeek%2Fsvg2shenzhen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbadgeek%2Fsvg2shenzhen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadgeek%2Fsvg2shenzhen/lists"}