Connecting GingerSlicer to the G1

GingerSlicer can connect to the G1 over the local network. When connected, you can upload files directly, start prints, and monitor temperatures without touching the printer display.

---

Setting up the connection

1. Make sure the G1 and the computer running GingerSlicer are on the same WiFi network
2. In GingerSlicer, open Printer settings → Printer host
3. Set the IP address to g1os.local (the default hostname) or the IP address shown on the printer display
4. Click Test connection — a green checkmark confirms the connection is live
5. Save the settings

Note

g1os.local relies on mDNS hostname resolution. On some Windows machines or corporate networks, mDNS may be blocked. If g1os.local does not resolve, use the numeric IP address shown on the printer display instead.

---

What you can do when connected

• Upload G-code files directly from GingerSlicer to the printer’s file list — no USB drive needed
• Start a print from GingerSlicer after upload
• Monitor temperatures (bed, nozzle zones) in real time from the slicer’s device panel
• Receive error notifications on the slicer when the printer throws a fault

---

What you cannot do when the print was started from the printer display

When a print is launched from the G1 display (not from GingerSlicer), the slicer’s connection is not the active session. In this case:

• Print progress and live stats are not shown in GingerSlicer
• Errors appear on the printer display only, not in GingerSlicer
• The print still runs correctly — the G-code is already on the printer

If you want to monitor and log the print from GingerSlicer, always use GingerSlicer to start the print, not the display.

Alternatively, open Mainsail in a browser for full live monitoring regardless of how the print was started.

---

WiFi vs USB for large files

For sliced files larger than approximately 100 MB, WiFi upload can be slow depending on your router and network conditions.

Recommendation:

• Files under 100 MB: WiFi upload from GingerSlicer is convenient and reliable
• Files over 100 MB: copy the file to a USB drive and insert it into the G1’s USB port for faster transfer

The G1 reads G-code directly from USB without any conversion or import step.

---

Troubleshooting

Printer not found / connection test fails

1. Confirm the printer and the computer are on the same WiFi network (not guest vs. main, not 2.4 GHz vs. 5 GHz if they are separate SSIDs)
2. Try using the numeric IP address instead of g1os.local
3. Check that the printer display shows the G1OS home screen (not a boot or error screen)
4. Restart the G1OS network service from Mainsail → System if needed

Connection was working and stopped

The printer’s IP address may have changed if assigned by DHCP. Check the current IP on the printer display and update GingerSlicer’s printer host setting. For a stable connection, assign a static IP to the G1 in your router’s DHCP settings.