{"id":5010,"date":"2026-08-30T02:40:36","date_gmt":"2026-08-29T17:40:36","guid":{"rendered":"https:\/\/donguri3.net\/server-tech\/install-pcb2gcodegui-on-ubuntu-wsl2-2\/"},"modified":"2026-08-30T02:40:37","modified_gmt":"2026-08-29T17:40:37","slug":"install-pcb2gcodegui-on-ubuntu-wsl2","status":"publish","type":"post","link":"https:\/\/donguri3.net\/en\/server-tech\/virtualization-container-wsl\/install-pcb2gcodegui-on-ubuntu-wsl2\/","title":{"rendered":"Installation Guide for pcb2gcodeGUI on WSL2 Ubuntu 22.04.4 LTS"},"content":{"rendered":"<p class=\"\">In this blog, we explain the step-by-step installation procedure for pcb2gcodeGUI on an Ubuntu 22.04.4 LTS environment running under WSL2. pcb2gcodeGUI is a useful tool that generates G-code from PCB data, but using it requires building its underlying dependencies: pcb2gcode and gerbv. The detailed procedure is outlined below.<\/p>\n<hr class=\"\" \/>\n<h2 class=\"\">Prerequisites for pcb2gcodeGUI<\/h2>\n<p class=\"\">To use pcb2gcodeGUI, the following components are required:<\/p>\n<ul>\n<li class=\"\">\n<p class=\"\"><strong>pcb2gcode<\/strong><\/p>\n<ul>\n<li class=\"\">\n<p class=\"\">Installing via apt installs version 1.1.4, but the recommended version is 1.3.2 or higher, so it must be built from source.<br \/>\n<a href=\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/Old-pcb2gcode-detected-Ubuntu-22.04-2025_03_23-14_47_14.png\"><img decoding=\"async\" class=\"aligncenter wp-image-1004 size-full\" src=\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/Old-pcb2gcode-detected-Ubuntu-22.04-2025_03_23-14_47_14.png\" alt=\"pcb2gcode Warning!\" width=\"576\" height=\"214\" srcset=\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/Old-pcb2gcode-detected-Ubuntu-22.04-2025_03_23-14_47_14.png 576w, https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/Old-pcb2gcode-detected-Ubuntu-22.04-2025_03_23-14_47_14-300x111.png 300w\" sizes=\"(max-width: 576px) 100vw, 576px\" \/><\/a><\/p>\n<\/li>\n<\/ul>\n<\/li>\n<li class=\"\">\n<p class=\"\"><strong>gerbv<\/strong><\/p>\n<ul>\n<li class=\"\">\n<p class=\"\">Required by pcb2gcode, version 2.1.0 or higher is needed. Since apt does not provide the latest version, this must also be built from source.<br \/>\nIf a version 2.1.0 or higher is not installed, the following error will occur during .\/configure.<\/p>\n<pre>checking for libgerbv &gt;= 2.1.0... no\nconfigure: error: Package requirements (libgerbv &gt;= 2.1.0) were not met:\n\nRequested 'libgerbv &gt;= 2.1.0' but version of libgerbv is\n\nConsider adjusting the PKG_CONFIG_PATH environment variable if you\ninstalled software in a non-standard prefix.\n\nAlternatively, you may set the environment variables gerbv_CFLAGS\nand gerbv_LIBS to avoid the need to call pkg-config.\nSee the pkg-config man page for more details.<\/pre>\n<\/li>\n<li class=\"\">\n<p class=\"\">The current latest version is v2.<span style=\"color: #ff0000;\">10<\/span>.0.<\/p>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<hr class=\"\" \/>\n<h2 class=\"\">Installing gerbv<\/h2>\n<p class=\"\">First, build and install gerbv. Proceed according to the steps below.<\/p>\n<div class=\"overflow-y-auto p-4\" dir=\"ltr\">\n<pre>sudo apt install build-essential automake autoconf autoconf-archive libtool libboost-program-options-dev libgtkmm-2.4-dev gerbv git librsvg2-dev\ngit clone https:\/\/github.com\/gerbv\/gerbv.git\ncd gerbv\ngit checkout -b v2.10.0 v2.10.0\nautoreconf -f -v -i\n.\/configure --disable-update-desktop-database\nmake\nsudo make install\n<\/pre>\n<\/div>\n<hr class=\"\" \/>\n<h2 class=\"\">Installing pcb2gcode<\/h2>\n<p class=\"\">Next, build and install the latest version of pcb2gcode from source.<\/p>\n<pre>git clone https:\/\/github.com\/pcb2gcode\/pcb2gcode.git\ncd pcb2gcode\ngit checkout -b v2.5.0 v2.5.0\nautoreconf -f -v -i\n.\/configure\nmake\nsudo make instlal<\/pre>\n<h2 class=\"\">Installing pcb2gcodeGUI<\/h2>\n<p class=\"\">Finally, install pcb2gcodeGUI. Follow the build instructions on GitHub, but since qt5-default is not provided, use qtbase5-dev as an alternative package.<\/p>\n<pre>sudo apt install build-essential git qt5base5-dev libqt5svg5-dev\ngit clone https:\/\/github.com\/pcb2gcode\/pcb2gcodeGUI.git\ncd pcb2gcodeGUI\ngit checkout -b v1.3.3 v1.3.3\nqmake\nmake\nsudo make install<\/pre>\n<hr class=\"\" \/>\n<h2>Execution Result<\/h2>\n<p>Running pcb2gcodeGUI will display a window like the one below:<br \/>\n<a href=\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_23-15_03_22.png\"><img decoding=\"async\" class=\"aligncenter wp-image-1005 size-full\" src=\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_23-15_03_22.png\" alt=\"pcb2gcodeGUI\" width=\"983\" height=\"608\" srcset=\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_23-15_03_22.png 983w, https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_23-15_03_22-300x186.png 300w, https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_23-15_03_22-768x475.png 768w\" sizes=\"(max-width: 983px) 100vw, 983px\" \/><\/a><\/p>\n<p>After that, configure various settings, set your Gerber and Excellon drill files in the Input\/output tab, and click the Start button to generate the G-code file.<br \/>\n<a href=\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/04\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_29-12_46_14.png\"><img decoding=\"async\" class=\"aligncenter wp-image-1062 size-full\" src=\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/04\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_29-12_46_14.png\" alt=\"Installation Guide for pcb2gcodeGUI on WSL2 Ubuntu 22.04.4 LTS\" width=\"983\" height=\"503\" srcset=\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/04\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_29-12_46_14.png 983w, https:\/\/donguri3.net\/wp-content\/uploads\/2025\/04\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_29-12_46_14-300x154.png 300w, https:\/\/donguri3.net\/wp-content\/uploads\/2025\/04\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_29-12_46_14-768x393.png 768w, https:\/\/donguri3.net\/wp-content\/uploads\/2025\/04\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_29-12_46_14-530x271.png 530w, https:\/\/donguri3.net\/wp-content\/uploads\/2025\/04\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_29-12_46_14-565x289.png 565w, https:\/\/donguri3.net\/wp-content\/uploads\/2025\/04\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_29-12_46_14-710x363.png 710w, https:\/\/donguri3.net\/wp-content\/uploads\/2025\/04\/pcb2gcodeGUI-Ubuntu-22.04-2025_03_29-12_46_14-725x371.png 725w\" sizes=\"(max-width: 983px) 100vw, 983px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<h2 class=\"\">Conclusion<\/h2>\n<p class=\"\">In this tutorial, we explained how to build from source and install the necessary dependent software (gerbv and pcb2gcode) in order to use pcb2gcodeGUI on WSL2 Ubuntu 22.04.4 LTS. Since the latest versions are not provided via apt, building from source is essential. This sets up an environment to generate high-precision G-code from PCB data while ensuring the latest features and stability.<\/p>\n<p class=\"\">By accurately following each step, you will be able to efficiently utilize pcb2gcodeGUI on WSL2, so please give it a try.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>In this blog, we explain the step-by-step installation procedure for pcb2gcodeGUI on an Ubuntu 22.04.4 LTS env [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":1062,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_locale":"en_US","_original_post":"https:\/\/donguri3.net\/?p=1003","footnotes":""},"categories":[1171],"tags":[51,430,420,52,419,352,100,365],"class_list":["post-5010","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-virtualization-container-wsl","tag-git","tag-github","tag-g","tag-https","tag-pcb2gcodegui","tag-ubuntu","tag-ubuntu-22-04","tag-wsl2","en-US"],"_links":{"self":[{"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/posts\/5010","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/comments?post=5010"}],"version-history":[{"count":1,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/posts\/5010\/revisions"}],"predecessor-version":[{"id":5013,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/posts\/5010\/revisions\/5013"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/media\/1062"}],"wp:attachment":[{"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/media?parent=5010"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/categories?post=5010"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/tags?post=5010"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}