Connect Your Printer to Neome Cloud
This guide shows how to connect your 3D printer using the generated client_id.
1. Create Your Client ID
Click GENERATE at the top of this page, or enter your own
client_id.
Use the same client_id in the printer connector configuration.
2. Install Python
Download Python from the official website:
⬇ Download Python
- Windows: during install, check Add Python to PATH
- macOS / iOS: iPhone and iPad cannot run the connector directly. Use a Mac, Windows PC, Linux machine, or Raspberry Pi.
- Linux: install Python using your package manager if it is not already installed.
3. Download the Printer Connector
⬇ Download NEOME_PRINTER.zip
Extract the ZIP anywhere on your computer.
Folder Structure
NEOME_PRINTER/
├─ jobs/
├─ printers/
├─ neome_printer.py
└─ requirements.txt
4. Add Your Printer
Create a JSON file inside the printers folder.
{
"ip": "",
"code": "",
"serial": "",
"api": "YOUR_CLIENT_ID"
}
ip, code, and serial come from your printer.
api must be the same client_id shown at the top of this page.
5. Start the Connector
Open a terminal or command prompt inside the NEOME_PRINTER folder.
First time setup
Windows:
cd NEOME_PRINTER
py -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python neome_printer.py
macOS / Linux:
cd NEOME_PRINTER
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 neome_printer.py
Next time you start it
Windows:
cd NEOME_PRINTER
.venv\Scripts\activate
python neome_printer.py
macOS / Linux:
cd NEOME_PRINTER
source .venv/bin/activate
python3 neome_printer.py
Once running, your printer should automatically appear on this page within a few seconds.
Done
Once the connector is running, your printer will automatically appear on this page.
How This Page Works
This page shows every printer connected with the same client_id.
When your connector is running, your printer appears here automatically.
- ONLINE means the printer is connected and ready.
- SEND uploads a print file to that printer.
- CANCEL stops the current print when available.
- PUT ONLINE unlocks the printer after a print is finished.
- Log shows live messages between the page, cloud, connector, and printer.
What Is Setting 3MF?
Setting 3MF is a tiny saved print profile for one machine.
It stores the printer model, plate type, nozzle, filament slots,
and print settings you want to reuse.
To create one, make a simple cube in your slicer and set the cube size to:
0.01 × 0.01 × 0.01 mm
Then choose all the settings you want to reuse for similar prints.
Export it as:
setting.3mf
This makes printing easier:
one setting file per machine,
many prints using the same trusted setup.
Printer Information Explained
- Status: shows if the printer is online, offline, or busy.
- Printer state: live printer state, such as READY or PRINTING.
- Progress: current print progress.
- Time left: estimated remaining print time.
- Model: printer model detected by the connector.
- Firmware: printer firmware version.
- Nozzle / Bed / Chamber temp: live temperatures.
- Nozzle info: nozzle size and type.
- AMS: filament system information if available.
- Hardware: machine size, nozzle, and plate from the setting file.
- Filament: filament slots detected from the setting file.