PocketPrint3D

Help

Two guides: start with the first one. The second explains everything you can add later – all of it is optional.

BeginnersGetting startedFrom installing the app to your first print – 7 steps, about 10 minutes. AdvancedMore possibilitiesPrint from anywhere, on your computer, from OrcaSlicer, spools, multicolour, your own server.

Getting started

You need: your 3D printer switched on and connected to your Wi-Fi (Elegoo Centauri Carbon, a Klipper printer, a Prusa with PrusaLink or an OctoPrint setup), your phone on the same Wi-Fi, and an e-mail address. Nothing to install at home.
  1. Install the app

    Android: currently as a beta test in Google Play. iPhone: coming soon. On a computer you can use app.pocketprint3d.com with the same account.

  2. Sign up – just your e-mail

    Tap Sign up for free, enter your e-mail and type in the 6-digit code you receive. No password.

  3. Add your printer

    Tap Add printer. The app searches your Wi-Fi and lists your printer – tap it, then Save. Prusa: also enter the PrusaLink password (printer screen → Settings → Network). OctoPrint: an API key (OctoPrint → Settings → Application Keys).

  4. Find a model

    In Discover search Printables or Thingiverse. Or share a model link from your browser with PocketPrint3D, or open a file (STL, 3MF, OBJ, STEP) with Choose a file.

  5. Prepare the print

    Choose material and quality – the defaults fit most models. Supports only for overhangs. Then Prepare print: after about a minute you see print time, filament and a preview.

  6. Print

    Check the preview, tap Print and confirm that the build plate is empty and the right material is loaded. Nothing ever starts without this confirmation.

  7. Watch it

    The Printers tab shows progress, remaining time and temperatures. Pause, resume or cancel there. In Jobs the print shows as “Printing”, then “Printed” or “Cancelled”. Want it again? Open the job and tap Print again.

If something doesn't work

The printer isn't found
Is it switched on and is your phone on the same Wi-Fi (not on mobile data, not on a guest network)? A VPN on the phone (e.g. Tailscale) can block the search too: switch it off for a moment. Tap Search again, or Enter the address yourself – the printer shows its IP address in its network menu.
"Not reachable"
At home the app talks to the printer directly. Away from home this only works with a bridge (see below).
The file is on the printer but the print didn't start
Some printers ignore the start command now and then. Start the file on the printer's screen – it is already there.
The job still says “Printing” although the print is done
The job learns it from the printer: through a bridge within a minute, without a bridge when your phone is home and the app shows the Printers tab. Open it once on your home Wi-Fi.
The model is too big or slicing fails
Try a smaller size (Size in "On the plate") or another file of the model.

For advanced users

Everything here is optional. Most of it is under Settings → Advanced.

Choose your setup

Cloud onlyCloud + bridgeOwn server
Install at homenothinga small bridge (Docker, Home Assistant, Raspberry Pi)PocketPrint3D server (Unraid, Home Assistant, Docker)
Slicingin the cloudin the cloudat home
Printing at home✓ phone on the Wi-Fi✓✓
Printing from anywhere–✓ also from the browser✓ with the bridge switch (or Tailscale)
Camera, controls, time-lapse–✓✓
Extrasmodel library, AI failure detection, smart plug, exact Klipper times

Control the printer

On the Printers tab, Control opens one page per printer with everything else – never while a print runs:

Print from anywhere (bridge)

New to this? Set up a bridge on a Raspberry Pi – shopping list (about €60) and a ready-made card image: write it, plug in cable and power, tap “Connect” in the app.
  1. Run a bridge at home: on your own PocketPrint3D server switch on Connect to PocketPrint3D Cloud (Unraid template, Home Assistant add-on option, or the server's web page → Settings). Without a server: the small Docker image ghcr.io/halvar20000/printshare-bridge.
  2. The bridge shows a code (container log or its web page).
  3. In the app: Settings → Advanced → Print from anywhere, enter the code, Connect.
  4. The bridge's printers appear in your account, marked "through a bridge". More printers: Add a printer through the bridge – address and password are encrypted so only your bridge can read them.

Only an outgoing connection: nothing to open in your router, your printers stay off the internet.

On your computer

Send from OrcaSlicer

Why through PocketPrint3D? OrcaSlicer can often reach your printer directly – but then the print bypasses PocketPrint3D. Through PocketPrint3D:
  • Spools stay right: the used filament is booked like for every other print.
  • From anywhere: slice on the laptop at work, the printer at home prints – through your bridge.
  • One overview: the print shows up in the app and the browser – preview, progress, camera, pause.
  • Check first, start later: “Upload” gets the print ready; you start it on your phone once the plate is clear, and choose spool and slot there.

You don't manage spools and only print at home? Then sending directly from OrcaSlicer is just as good. You don't add a new printer in OrcaSlicer – you give your real printer another way: through PocketPrint3D.

  1. In the app or browser: Settings → your printer → Send from OrcaSlicer on your computer → Create access. You get an address and a key (shown once).
  2. In OrcaSlicer: Wi-Fi icon next to the printer (add physical printer) → host type Octo/Klipper → enter address and key → Test.
  3. After slicing: Upload – the print waits as a job in the app. Upload and print – starts right away on a printer behind a bridge and books the spool used last.

Filament spools

Time-lapse

Bambu Lab printers (P1S, P1P, X1, A1)

  1. On the printer: Settings → WLAN, switch on LAN Only Mode; with newer firmware also Developer Mode (shown below it). The 8-character access code is on the same screen. Without LAN mode the printer shows its status but ignores print jobs from other apps. In LAN mode it is no longer connected to the Bambu cloud (Bambu Handy).
  2. In the app: Add printer – the printer shows up as “Bambu Lab P1S” (Android, at home) or through Add a printer through the bridge. Enter the access code; the printer model is chosen for you.
  3. Printing: choose the AMS tray for every colour; the camera picture, time-lapse and the light work as with other printers.

Your own camera (RTSP / webcam)

For printers behind a bridge: Settings → your printer → Own camera, enter e.g. rtsp://user:password@192.168.1.60/live (Eufy: …/live0, Wyze: …/live, a Raspberry Pi with mediamtx: rtsp://IP:8554/cam) or a webcam address (http://IP/capture for an ESP32-CAM). It replaces the built-in camera for the picture, time-lapse and AI failure detection. Camera mounted on its side? Add #rotate=90 (or 180, 270) to the address – PocketPrint3D turns the picture clockwise; it is never sent to the camera. The address is sent encrypted to the bridge. Own server: camera_url: in config.yaml.

Multicolour (AFC / CANVAS)

For multicolour models choose the slot for every colour before preparing; empty slots are flagged, and the material follows the filament in the slot. Supported on Klipper printers with AFC (e.g. Centauri Carbon with COSMOS + CANVAS).

Your own OrcaSlicer profiles

Settings → your printer → Printer profile: upload your OrcaSlicer printer, quality and material profiles, or paste the link of a public Orca Cloud bundle. They are used for slicing right away.

Extras with your own server

Your model library
Manyfold at home shows up as a search source next to Printables.
AI failure detection
With Obico's ML API, camera pictures are checked while printing; a likely failure can pause the print.
Printer on/off
A smart plug in Home Assistant switches the printer on and off from the app.
Exact times for Klipper
Print times recalculated with your printer's own limits (klipper_estimator).

Installation and details: GitHub (README). Something missing or not working? Open an issue there.