Home

Awesome

fluiddpi

A pi image with Klipper, Moonraker and Fluidd pre-installed.

This repository contains the necessary code to generate the distribution from an existing Raspberry Pi OS lite distro image.

Deprecated

⚠️ WARNING ⚠️

FluiddPI is not under active maintenance and we’ve had reports from users finding issues while using it.

As such, our recommendation is that you do not use FluiddPI, and instead use KIAUH to install Fluidd.

Where to download?

You can download the latest release here.

Older releases can be found here.

How to use?

  1. Download the image as per above and install on an sdcard like you would any other Raspberry pi image.
  2. Optionally, if you require WiFi, configure by editing the fluiddpi-wpa-supplicant.txt on the root of the sd card - whilst it is still connected to your computer.
  3. Boot your Pi from the new sd card.
  4. Log into your Pi via SSH (located at fluiddpi.local). Default username is pi and password is raspberry.
  5. Best practice would have you;
    • sudo apt-get update
    • sudo apt-get upgrade
    • sudo raspi-config
      • Change your password
      • Define your timezone via 'Localization Options'
      • Optionally Change your hostname
  6. Reboot.

Fluidd will be available at http://fluiddpi.local - and will present an error about a missing printer.cfg file.

Please ensure your printer.cfg is configured correctly for Fluidd, see the fluidd docs here. Once this is complete, you can now progress with your standard printer setup.

Compiling / Developing Quick Start

Regular users of FluiddPI should not need to follow any of these steps. This is for those that wish to compile their own image and / or help in the development of this project.

Requirements

Recommended environment is Ubuntu or similar, with docker and docker-compose installed.

# Packages for Ubuntu 18.04/20.04
# Dekstop variants are known to cause issues during build due to snaps takeing up loop mounts **

sudo apt-get install gawk make build-essential util-linux \
qemu-user-static qemu-system-arm \
git p7zip-full python3 curl
# To build;
git clone https://github.com/fluidd-core/FluiddPI.git
cd FluiddPI/
make build
# To test;
# To exit emulation - Ctrl-a x
./run.sh
# Other make options

# Clean all previous build items except the source raspian image
make clean

# Clean up the source image and trigger a new download
make distclean

Build layout

fluiddpi/
  /emulation - Contains dependencies for emulation testing
  /src/image - Contains our base Raspberry Pi OS image
  /src/workspace - Created during build, and output for compiled images

With Thanks

FluiddPI wouldn't be possible without the hard work of Raymond Himle, Stefan Dej and the team behind CustomPiOS. Thank you!