https://github.com/fluidd-core/fluiddpi
FluiddPi - A Pi image with Klipper, Moonraker, Fluidd and Web Camera support pre-installed.
https://github.com/fluidd-core/fluiddpi
Last synced: 5 months ago
JSON representation
FluiddPi - A Pi image with Klipper, Moonraker, Fluidd and Web Camera support pre-installed.
- Host: GitHub
- URL: https://github.com/fluidd-core/fluiddpi
- Owner: fluidd-core
- License: gpl-3.0
- Created: 2021-06-21T22:01:50.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2023-08-05T12:28:41.000Z (almost 2 years ago)
- Last Synced: 2024-12-16T00:05:21.221Z (5 months ago)
- Language: Shell
- Homepage: https://docs.fluidd.xyz
- Size: 3.78 MB
- Stars: 303
- Watchers: 15
- Forks: 60
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/th33xitus/kiauh) to install Fluidd.
## Where to download?
You can download the latest release [here](https://github.com/fluidd-core/FluiddPI/releases/latest).
Older releases can be found [here](https://github.com/fluidd-core/FluiddPI/releases).
## 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](https://docs.fluidd.xyz). 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.
- bash
- git
- [docker](https://docs.docker.com/engine/install/ubuntu/)
- [docker-compose](https://docs.docker.com/compose/install/)
- [qemu-arm-static](http://packages.debian.org/sid/qemu-user-static)
- QEMU for emulation
- around ~5gb free space
```bash
# 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
```
```bash
# To build;
git clone https://github.com/fluidd-core/FluiddPI.git
cd FluiddPI/
make build
```
```bash
# To test;
# To exit emulation - Ctrl-a x
./run.sh
```
```bash
# 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
```bash
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!