Skip to content

skittleson/GcodeController

Repository files navigation

Gcode Controller

Minimal Web UI for gcode to serial devices. GcodeController is a small app to manage your gcode jobs with the least amount of setup. Use for Grbl, Marlin, RepRap and other firmware that accepts gcode.

✅ Minimal UI

✅ Start/Stop/Pause a job with realtime progress

✅ Jog

✅ Console to execute gcode

✅ Upload/Manage Files

✅ API with OpenAPI documentation

✅ MQTT / WebSocket Support (Rest API responses matching)

✅ Detailed Logs

✅ Streaming Webcam support

✨ Demo

Demo gif

🚀 Quick Start

Download the latest release for your OS. Run the executable.

On Linux/Mac

chmod u+x GcodeController;
./GcodeController

Then go to http://<device ip>:8081. It's shown in the console logs.

Grant dialout access *nix based machine for non sudo users (Linux, Mac)
Check user for dialout access
id -Gn <username>
If missing  `dialout` from the list then
sudo usermod -a -G dialout <username>
logout and login to ensure access is granted.

API Docs

Endpoint Purpose
GET /api/ping Pong
GET /api/serial Current serial device connection
POST /api/serial Create and open serial device connection
DELETE /api/serial Close serial device connection
PUT /api/serial Send command to serial device
GET /api/job Job Status
POST /api/job Start job
PUT /api/job Pause job
DELETE /api/job Stop job
POST /api/files Upload single file to be used in job
GET /api/files Get all files
GET /api/files/{fileName} Get single file information
DELETE /api/files/{fileName} Remove single file

🤝 Contributing

Contributions, issues and feature requests are welcome.
Feel free to check issues page if you want to contribute.

Author

👤 Spencer Kittleson

Show your support

⭐️ this repository if this project helped you! It motivates us a lot! 👋

Buy me a coffee ☕: skittles

Built with ♥

📝 License

Copyright © 2021 Spencer Kittleson - Do Code That Matters.
This project is MIT licensed.

References

About

Manage and control sending gcode to serial devices

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors