ElegooRemoteControl (C++ Cassini Port)

ElegooRemoteControl is a native C++ GUI application designed to control and monitor Elegoo Saturn 3D printers over the network.

This project is a high-performance port of the original Python tool Cassini. It replicates the complex network logic (custom MQTT broker + HTTP server handshake) required to communicate with the printer's mainboard, but wrapped in a modern, easy-to-use Qt 6 interface.

Features

• Network Discovery: Automatically finds Saturn printers on the local network via UDP broadcast.
• Status Monitoring: Real-time feedback on printer status (Idle, Printing, Busy), current layer, and total layers.
• File Upload & Print: Allows uploading .goo or .ctb files directly to the printer and starting the print job immediately.
• Multi-language Support: The user interface is available in English and Spanish. It auto-detects the system language on startup and provides a selector to change it manually.
• Native Performance: Built with C++17 and Qt 6 for minimal resource usage and zero Python dependencies on the client machine.

Prerequisites

• Linux, Windows, or macOS.
• CMake (3.16 or higher).
• Qt 6 (Core, Network, Widgets, LinguistTools modules).
• C++ Compiler supporting C++17.

Installing Dependencies (Ubuntu/Debian)

sudo apt update
sudo apt install build-essential cmake qt6-base-dev qt6-base-dev-tools qt6-l10n-tools

Build Instructions

1. Clone the repository:

   git clone https://github.com/gokuhs/ElegooRemoteControl.git
   cd ElegooRemoteControl

2. Create a build directory and run CMake:

   mkdir build
   cd build
   cmake ..

3. Update and compile translations: If you have modified any translatable strings in the source code, you must update the .ts file using Qt's lupdate tool. You can then use Qt Linguist to edit the translations in translations/saturn_es.ts.

   # From the build directory
   lupdate .. -ts ../translations/saturn_es.ts

   After translating, the .ts files are automatically compiled into .qm files by make/cmake.

4. Compile the project:

   make

5. Run the application: After compiling, the build/translations directory will contain the saturn_es.qm file. The application executable needs to find this file at runtime. Make sure the translations directory is placed next to the SaturnControl executable. After compiling, the build/translations directory will contain the saturn_es.qm file. The application executable needs to find this file at runtime. Make sure the translations directory is placed next to the ElegooRemoteControl executable.

   A simple way to run it is to copy the translations folder into the build directory where the executable is:

   cp -r ../translations . 
   ./ElegooRemoteControl

Credits & License

• Original Logic (Cassini): Copyright (C) 2023 Vladimir Vukicevic (MIT License). This C++ port bases its reverse-engineered network protocol logic on his work.
• C++ Port: Developed as an open-source contribution.

---

ElegooRemoteControl (Versión en Español)

ElegooRemoteControl es una aplicación nativa en C++ con interfaz gráfica diseñada para controlar y monitorizar impresoras 3D Elegoo Saturn a través de la red local.

Este proyecto es un port de alto rendimiento de la herramienta original en Python llamada Cassini. Replica la compleja lógica de red (Broker MQTT personalizado + Handshake de servidor HTTP) necesaria para comunicarse con la placa base de la impresora, pero envuelta en una interfaz moderna y fácil de usar basada en Qt 6.

Características

• Descubrimiento de Red: Encuentra automáticamente impresoras Saturn en la red local mediante broadcast UDP.
• Monitorización de Estado: Información en tiempo real del estado de la impresora (En espera, Imprimiendo, Ocupada), capa actual y total de capas.
• Subida e Impresión: Permite subir archivos .goo o .ctb directamente a la impresora e iniciar el trabajo de impresión inmediatamente.
• Soporte Multi-idioma: La interfaz de usuario está disponible en inglés y español. Detecta automáticamente el idioma del sistema al arrancar y proporciona un selector para cambiarlo manualmente.
• Rendimiento Nativo: Construido con C++17 y Qt 6 para un uso mínimo de recursos y sin dependencias de Python en la máquina cliente.

Requisitos Previos

• Linux, Windows o macOS.
• CMake (3.16 o superior).
• Qt 6 (Módulos Core, Network, Widgets, LinguistTools).
• Compilador C++ con soporte para C++17.

Instalación de dependencias (Ubuntu/Debian)

sudo apt update
sudo apt install build-essential cmake qt6-base-dev qt6-base-dev-tools qt6-l10n-tools

Instrucciones de Compilación

1. Clona el repositorio:

   git clone https://github.com/gokuhs/ElegooRemoteControl.git
   cd ElegooRemoteControl

2. Crea un directorio de compilación y ejecuta CMake:

   mkdir build
   cd build
   cmake ..

3. Actualizar y compilar traducciones: Si has modificado alguna de las cadenas de texto traducibles en el código fuente, debes actualizar el archivo .ts con la herramienta lupdate de Qt. Después puedes usar Qt Linguist para editar las traducciones en translations/saturn_es.ts.

   # Desde el directorio 'build'
   lupdate .. -ts ../translations/saturn_es.ts

   Después de traducir, los archivos .ts se compilan automáticamente a .qm al ejecutar make/cmake.

4. Compila el proyecto:

   make

5. Ejecuta la aplicación: Después de compilar, el directorio build/translations contendrá el archivo saturn_es.qm. El ejecutable de la aplicación necesita encontrar este archivo en tiempo de ejecución. Asegúrate de que el directorio translations esté junto al ejecutable SaturnControl. Después de compilar, el directorio build/translations contendrá el archivo saturn_es.qm. El ejecutable de la aplicación necesita encontrar este archivo en tiempo de ejecución. Asegúrate de que el directorio translations esté junto al ejecutable ElegooRemoteControl.

   Una forma sencilla de ejecutarlo es copiar la carpeta de traducciones al directorio de compilación donde se encuentra el ejecutable:

   cp -r ../translations . 
   ./ElegooRemoteControl

Créditos y Licencia

• Lógica Original (Cassini): Copyright (C) 2023 Vladimir Vukicevic (Licencia MIT). Este port en C++ basa su lógica de protocolo de red e ingeniería inversa en su trabajo.
• Port C++: Desarrollado como contribución de código abierto.