Skip to content

Introduction

C0co edited this page Feb 4, 2026 · 11 revisions

Introduction

Writing this guide is pretty difficult because these printers are being used by a wide range of users.
Some are already tinkerers, makers or even hackers, while others bought this as their first 3D printer and dont even know what klipper is.

I try to cover it all what might make it (sometimes too) long for some - sorry for that :)

Important: To get started, you'll need an operating system (OS) that doesn’t block the serial port with background software.
The official QIDI OS is not suitable for this, as it includes software that interferes with the serial port. For more details, see Interaction between Software and the Display.

Choose Your Way

There are two options depending on the current state of your system:
Installation Tour #1: You have a stock system or want to start fresh (recommended).
Installation Tour #2: You have already installed a custom OS and only want to add FreeDi to get the Display funtionality

Note: Tour #2 is really intended for advanced users only who have already installed a clean OS and understood the process (e.g., following my FreeQIDI guide). It will only add my software in combination with my display firmware.

I have installation guides for either way.
You can navigate through this wiki using the right sidebar (or at the bottom if you're on mobile).

Please follow the complete guide step by step!
If you encounter any issues, it's likely that you missed a step or didn't fully understand what was meant to be done.
In that case, feel free to open a [Help] issue, as skipping steps could lead to more problems.

Next Chapter:

Important note about backups

📖 FREEDI WIKI
      🏠 Home

      ⭐ <- indicates recommended pages


🎬 VIDEO GUIDES
      German install guide from Chris
      Video Installation Guide
      X-Smart 3 Additional Guide


⚙️ INSTALLATION

Before You Start
      Introduction
Hardware Variations & Why Backups Matter
Creating a Backup
      Preserving Print History

⭐ Tour #1: Fresh Installation (Recommended)
      Step 1: Requirements
      Step 2: Installing FreeDi
      Q1 Pro: Flash Toolhead
      Plus4: Flash Toolhead

Tour #2: Add to Existing System (Advanced)
      Step 1: Requirements
      Step 2: Adjust Config
      Step 3: Install FreeDi


🎯 CALIBRATION

      Calibration Overview
Manual Bed Leveling
Z-Offset (Coarse)
Z-Offset Fine-Tuning
Input Shaping
Nozzle PID Tuning
Bed PID Tuning


🖨️ SLICER SETUP

General Slicer Setup
      OrcaSlicer
      QIDI Slicer


🔧 CONFIGURATION & UPDATES

      Beginner: Config Basics
Configuration Files Overview
      Advanced Configuration
Updating FreeDi
      Updating Klipper
      Mainsail Notifications


✨ POST-SETUP & ADDONS

      Enable WiFi
      Expand Filesystem
      Install Camera
      Time Lapse
      Static mesh
      Install Cartographer
      Change System Time
      Post Install & Config Section (Outdated)


❓ SUPPORT

      FAQ
      Community
      How to Report Bugs
      Menu Guide
      Features Overview


📚 KNOWLEDGE BASE

      How Software & Display Interact
      Menu Guide
      Features Overview
      Future Features


⚠️ ADVANCED / DANGER ZONE

      Flash EMMC via USB (No Reader)
      Restore Stock Firmware (Plus4)


📦 ARCHIVE (Old Versions)

v1.xx Installation Guide

Introduction
Requirements
Creating Backups
Stock Systems
Open Armbian Systems

≤ v1.03 (Archived)
Fresh Systems
Existing Systems
Display Flashing
Screen Firmware Selection

Clone this wiki locally