SunGo Project Manager
[EN] English description is available below.
[PL] Opis w języku polskim znajduje się poniżej.
[EN] SunGo Project Manager
SunGo Project Manager is a streamlined, efficient tool for managing your Go language projects inside Visual Studio Code, designed for simplicity and a clean, professional workflow.
📖 Table of Contents
📦 Requirements & Installation
Before installing SunGo Project Manager, make sure the following tools are available on your system. All of them are required for full functionality (building, linting, GUI libraries, and PAD communication).
1. Visual Studio Code
The extension runs inside VS Code.
🔗 Download VS Code
2. Go Official VS Code Extension (gopls)
Provides language server support, IntelliSense, and gopls integration. Install directly from the VS Code Marketplace.
🔗 Go Extension for VS Code
3. Go Compiler
The Go toolchain is required for building and running your projects.
🔗 Download Go
4. GCC Compiler – TDM-GCC 64-bit (v10.3.0)
Required for building native GUI libraries such as Fyne and Raylib that depend on CGO. Use the TDM-GCC 64-bit build:
🔗 Download TDM-GCC (tdm64-1) 10.3.0
⚠️ Make sure gcc is available in your system PATH after installation. You can verify with gcc --version in a terminal.
5. PowerShell 7 (Core)
SunGo uses PowerShell scripts for certain automation tasks. PowerShell 7 (cross-platform Core edition) is required.
🔗 Download PowerShell 7
6. Git
Required for version control integration and dependency management.
🔗 Download Git
7. (Optional) Go GUI Libraries
If your project uses graphical interfaces, install the relevant library:
| Library |
Purpose |
Install |
| Fyne |
Cross-platform GUI toolkit |
go get fyne.io/fyne/v2 |
| Raylib-go |
Game / multimedia framework |
go get github.com/gen2brain/raylib-go/raylib |
Both Fyne and Raylib require GCC (step 4) to compile via CGO.
✅ Quick Checklist
[ ] VS Code installed
[ ] Go official extension (gopls) installed
[ ] Go compiler installed and in PATH
[ ] TDM-GCC 64-bit 10.3.0 installed and in PATH
[ ] PowerShell 7 (Core) installed
[ ] Git installed
[ ] (Optional) Fyne / Raylib-go for GUI projects
Installing SunGo Project Manager
Search for "SunGo Project Manager" in the VS Code Extensions panel, or install directly from the Marketplace:
🔗 SunGo Project Manager on VS Code Marketplace
🎛 SunGO PAD – Visual Status Feedback
The physical SunGO PAD provides real-time visual feedback via native HID RAW communication. Key backlight colors dynamically reflect the current state of your build pipeline — without ever needing to glance at the terminal.
- ⚪ Idle – system ready, waiting for action
- 🟢 Green – RUN / Build completed successfully
- 🔴 Red – linter or compilation error detected
Note: The SunGo extension is fully functional without the physical hardware. The PAD is an optional companion device that replaces status bar controls with tactile buttons and vivid LED feedback for a more immersive development experience.
🔧 Firmware & Build
Detailed firmware releases, flashing instructions, and build information for the SunGO PAD are documented on the official forum:
🔗 SunGO PAD – Official Thread
🚀 What's New (v0.3.2)?
- New Demoscene EASTER EGG – You have to see this one for yourself.
🚀 What's New (v0.3.1)?
- PAD LED Brightness Control – Added smooth, real-time backlight intensity adjustment for all keys.
🚀 What's New (v0.3.0)?
- PAD Color Customization – New Webview interface to assign custom colors to each of the 9 buttons individually.
- Configuration Memory – Persistent storage for button color assignments across VS Code sessions using
globalState.
- Firmware v2.3 Sync – Fixed HID key mapping to eliminate the button function offset bug.
- Registration Stability – Resolved "command already exists" errors that occurred during extension reload.
- Clean Boot – Replaced legacy color defaults with the new professional SunGo palette.
🚀 What's New (v0.2.9)?
- Extended PAD Color System – Added new action colors (Blue, White, Yellow, Purple) via HID RAW.
- Real-Time Action Feedback – Physical PAD reflects live states: format, build, run, and signing.
- HID RAW Stability – Improved device detection and automatic reinitialization after disconnects.
- Per-Key State Preservation – Each button independently retains its color state.
- Intelligent PAD Command Queue – Throttling and buffering for reliable HID communication.
- Enhanced Firmware Integration – Full support for new PAD commands:
B, W, Y, P, C, R, E, and O.
📂 Version Archive
Expand previous changes (v0.2.8 – v0.0.9)
🚀 v0.2.8
- SunGO PAD Support – Color integration for RUN, BUILD, and linter error states.
- Refactoring – KeyPAD and Security logic separated into dedicated source files.
🚀 v0.2.6
- SunGo Dedicated Pad Support – Full integration with the custom 9-key mechanical macro pad. Control building, running, and signing processes with physical hardware.
- Advanced Console Control – New
Hide Console Window option via -H=windowsgui flag.
🚀 v0.2.5
- Advanced Test Engine – Brand new module integrating
go test with a graphical UI.
- Automated Test Generation – Generates
main_test.go for every new project automatically.
- SunRiver Cow Says (ASCII Art) – Notification system triggered on successful test runs.
🚀 v0.1.5 (Security Suite)
- Code Signing (Sign) – Digitally sign your binaries immediately after compilation.
- File Unlocking (Unlock) – Remove permission flags that prevent executables from running.
🛠 Key Features
- Automated Project Structure – Create
src/ folder and main.go with a single click.
- Debugger Configuration – Automatically generates a ready-to-use
launch.json — no manual path editing required.
- Binary Headers – Each new
main.go gets a unique project name encoded in binary format as a header.
- Binary Optimization – Automatic
-s -w linker flags for smaller, faster executables.
- Localization – Full support for Polish and English interfaces.
| Component |
Windows |
Linux |
| SunGo VS Code Extension |
✅ |
✅ |
| SunGO PAD (HID RAW) |
✅ |
✅ |
The extension works fully on both Windows and Linux. The physical SunGO PAD communicates via HID RAW and is supported on both platforms as well. The PAD is entirely optional — the extension is 100% functional without it.
👤 About the Author
Andrzej Gromczyński (SunRiver) – electronics enthusiast, embedded systems programmer, and technical author at Helion Publishing. Active community member and forum at forum.lothar-team.pl.
📚 Books (Helion)
🔗 All titles on Helion.pl
⚖️ License
Proprietary (Freeware) – Free for both private and commercial use in compiled form.
Copying, modifying, decompiling, or redistributing without the author's written consent is prohibited.
See the LICENSE file for full terms.
[PL] SunGo Project Manager
SunGo Project Manager to proste i skuteczne narzędzie do zarządzania projektami w języku Go, stworzone z myślą o wygodzie i porządku w kodzie.
📖 Spis treści
📦 Wymagania i Instalacja
Przed zainstalowaniem wtyczki SunGo Project Manager upewnij się, że poniższe narzędzia są dostępne w Twoim systemie. Wszystkie są wymagane do pełnej funkcjonalności (budowanie, linting, biblioteki GUI, komunikacja z PAD).
1. Visual Studio Code
Wtyczka działa wewnątrz VS Code.
🔗 Pobierz VS Code
2. Oficjalna wtyczka Go dla VS Code (gopls)
Zapewnia obsługę serwera językowego, IntelliSense oraz integrację z gopls. Zainstaluj bezpośrednio z VS Code Marketplace.
🔗 Wtyczka Go dla VS Code
3. Kompilator Go
Wymagany do budowania i uruchamiania projektów.
🔗 Pobierz Go
4. Kompilator GCC – TDM-GCC 64-bit (v10.3.0)
Wymagany do budowania natywnych bibliotek GUI takich jak Fyne i Raylib, które korzystają z CGO.
🔗 Pobierz TDM-GCC (tdm64-1) 10.3.0
⚠️ Upewnij się, że gcc jest dostępny w zmiennej środowiskowej PATH. Możesz to sprawdzić komendą gcc --version w terminalu.
5. PowerShell 7 (Core)
SunGo korzysta ze skryptów PowerShell do automatyzacji zadań. Wymagana jest wersja 7 (edycja Core).
🔗 Pobierz PowerShell 7
6. Git
Wymagany do integracji z kontrolą wersji i zarządzania zależnościami.
🔗 Pobierz Git
7. (Opcjonalnie) Biblioteki GUI dla Go
Jeśli Twój projekt korzysta z interfejsów graficznych, zainstaluj odpowiednią bibliotekę:
| Biblioteka |
Zastosowanie |
Instalacja |
| Fyne |
Wieloplatformowy toolkit GUI |
go get fyne.io/fyne/v2 |
| Raylib-go |
Framework do gier i multimediów |
go get github.com/gen2brain/raylib-go/raylib |
Obie biblioteki wymagają GCC (krok 4) do kompilacji przez CGO.
✅ Szybka lista kontrolna
[ ] VS Code zainstalowany
[ ] Oficjalna wtyczka Go (gopls) zainstalowana
[ ] Kompilator Go zainstalowany i dostępny w PATH
[ ] TDM-GCC 64-bit 10.3.0 zainstalowany i dostępny w PATH
[ ] PowerShell 7 (Core) zainstalowany
[ ] Git zainstalowany
[ ] (Opcjonalnie) Fyne / Raylib-go dla projektów GUI
Instalacja SunGo Project Manager
Wyszukaj „SunGo Project Manager" w panelu Rozszerzeń VS Code lub zainstaluj bezpośrednio z Marketplace:
🔗 SunGo Project Manager na VS Code Marketplace
🎛 SunGO PAD – Visual Status Feedback
Fizyczny SunGO PAD zapewnia natychmiastowy feedback wizualny w czasie rzeczywistym poprzez HID RAW. Kolory klawiszy odzwierciedlają aktualny stan procesu (RUN, BUILD, LINTER, ERROR) bez konieczności patrzenia w terminal.
- ⚪ Idle – system gotowy do pracy
- 🟢 Green – RUN / Build zakończony sukcesem
- 🔴 Red – błąd lintera lub kompilacji
Ważne: Wtyczka SunGo działa w pełni autonomicznie. Posiadanie fizycznego PAD-a nie jest wymagane, ale znacząco podnosi komfort pracy poprzez fizyczne przyciski sterujące i sygnalizację LED.
🔧 Firmware & Build
Szczegółowe instrukcje flashowania oraz informacje o budowie SunGO PAD znajdują się na oficjalnym forum:
🔗 https://forum.lothar-team.pl/viewtopic.php?t=1092
🚀 Co nowego (v0.3.2)?
- Nowy Demoscenowy EASTER EGG – Musicie to zobaczyć!
🚀 Co nowego (v0.3.1)?
- Kontrola jasności diod PAD – Teraz dostępna jest płynna regulacja jasności podświetlenia klawiszy.
🚀 Co nowego (v0.3.0)?
- Personalizacja kolorów PAD – Nowy interfejs Webview umożliwiający przypisanie własnych kolorów do każdego z 9 przycisków.
- Pamięć konfiguracji – Automatyczne zapisywanie i odtwarzanie kolorów przycisków po restarcie VS Code (
globalState).
- Synchronizacja z Firmware v2.3 – Poprawione mapowanie klawiszy HID, eliminujące przesunięcie funkcji przycisków.
- Stabilność rejestracji – Rozwiązano problem duplikacji komend przy przeładowywaniu rozszerzenia.
- Optymalizacja startu – Usunięcie starych wartości domyślnych kolorów na rzecz nowej palety SunGo.
🚀 Co nowego (v0.2.9)?
- Rozszerzony System Kolorów PAD – Nowe komendy kolorów (Blue, White, Yellow, Purple) przez HID RAW.
- Kolory Akcji w czasie rzeczywistym – Fizyczny PAD odzwierciedla stan (format, build, run, signing).
- Stabilność HID-RAW – Ulepszony mechanizm wykrywania urządzenia i ponownej inicjalizacji.
- Inteligentna kolejka komend – Throttling i buforowanie komend dla stabilnej transmisji HID.
- Lepsza integracja z firmware – Obsługa nowych komend:
B, W, Y, P, C, R, E, O.
📂 Archiwum wersji
Rozwiń poprzednie zmiany (v0.2.8 - v0.0.9)
🚀 v0.2.8
- SunGO PAD Support – Integracja kolorów dla RUN, BUILD i błędów lintera.
- Refaktoryzacja – Obsługa KeyPADA i Security w osobnych plikach.
🚀 v0.2.6
- SunGo Dedicated Pad Support – Pełna integracja z 9-przyciskową klawiaturą mechaniczną.
- Zaawansowana Kontrola Konsoli – Opcja
Hide Console Window (-H=windowsgui).
🚀 v0.2.5
- SunGo Test Engine – Nowy moduł integrujący
go test z GUI.
- SunRiver Cow says (ASCII Art) – System powiadomień po zdanym teście.
🚀 v0.1.5 (Security Suite)
- Podpisywanie Cyfrowe (Sign) – Podpisywanie binarek bezpośrednio po kompilacji.
- Naprawa uprawnień (Unlock) – Automatyczne usuwanie blokad systemowych.
🛠 Kluczowe Funkcje
- Struktura na start – Automatyczne tworzenie folderu
src/ i pliku main.go.
- Konfiguracja Debuggera – Generowanie
launch.json bez ręcznego wpisywania ścieżek.
- Binarne Nagłówki – Każdy nowy plik
main.go otrzymuje nazwę projektu zakodowaną binarnie.
- Lokalizacja – Obsługuje języki polski i angielski.
| Komponent |
Windows |
Linux |
| Wtyczka SunGo dla VS Code |
✅ |
✅ |
| SunGO PAD (HID RAW) |
✅ |
✅ |
Wtyczka działa w pełni zarówno na Windows, jak i na Linux. Fizyczny SunGO PAD komunikuje się przez HID RAW i jest obsługiwany na obu platformach. PAD jest w pełni opcjonalny — wtyczka działa w 100% bez niego.
👤 O autorze
Andrzej Gromczyński (SunRiver) – pasjonat elektroniki, programista systemów wbudowanych i autor książek technicznych w wydawnictwie Helion. Aktywny uczestnik społeczności prowadzi forum forum.lothar-team.pl.
📚 Książki (Helion)
🔗 Wszystkie tytuły na Helion.pl
⚖️ Licencja
Proprietary (Freeware) – Bezpłatne do użytku prywatnego i komercyjnego w formie skompilowanej.
Kopiowanie, modyfikowanie, dekompilowanie lub redystrybucja bez pisemnej zgody autora jest zabroniona.
Pełne warunki licencji znajdują się w pliku LICENSE.
