logan/touchprint
1
0
Fork 0
Code Issues 2 Pull requests Releases 2 Wiki Activity
A fork of Raspberry Pi OS that runs OctoPrint and a GUI
11 commits 3 branches 2 tags 1.2 MiB
Shell 96.5%
Python 2.2%
Dockerfile 0.8%
sed 0.5%
Find a file
Logan Gartner c7f44ec412
Added HTTP basic auth, default octoprint config 
Added HTTP basic auth to MJPG stream, so now you don't have to worry
about creeps watching your printer

Nginx now runs as www-data

Frontend specific files are no longer put into /etc/skel, they are now
only installed to the kiosk account

OctoPrint now has a default config so that users don't have to configure
system stuff (ex. You don't have to input /webcam/ into the stream box
anymore)

Restart Browser button now kills old Surf sessions

The Raspberry Pi now starts with the Raspberry Pi cameras enabled on
first boot

OctoPrint can now shutdown, reboot and restart its own service using
sudo without a password

Kiosk account no longer has a password since you aren't supposed to
login as kiosk anyways
2020-08-26 21:30:10 -06:00
export-image Initial commit 2020-08-17 17:54:31 -06:00
export-noobs Initial commit 2020-08-17 17:54:31 -06:00
scripts Initial commit 2020-08-17 17:54:31 -06:00
stage0 Initial commit 2020-08-17 17:54:31 -06:00
stage1 Added HTTP basic auth, default octoprint config 2020-08-26 21:30:10 -06:00
stage2 Added HTTP basic auth, default octoprint config 2020-08-26 21:30:10 -06:00
stage3 Added HTTP basic auth, default octoprint config 2020-08-26 21:30:10 -06:00
.dockerignore Initial commit 2020-08-17 17:54:31 -06:00
.gitignore Initial commit 2020-08-17 17:54:31 -06:00
build-docker.sh Initial commit 2020-08-17 17:54:31 -06:00
build.sh Added Golang MJPG Streamer, updated TODO 2020-08-20 02:56:51 -06:00
depends Initial commit 2020-08-17 17:54:31 -06:00
docker-compose.yml Initial commit 2020-08-17 17:54:31 -06:00
Dockerfile Added Golang MJPG Streamer, updated TODO 2020-08-20 02:56:51 -06:00
LICENSE Updated license and TODO, massive MJPG improvements 2020-08-24 03:04:27 -06:00
README-pigen.md Initial commit 2020-08-17 17:54:31 -06:00
README.md Updated README 2020-08-24 23:39:30 -06:00
TODO.md Added HTTP basic auth, default octoprint config 2020-08-26 21:30:10 -06:00

README.md

TouchPrint

TouchPrint is a lightweight fork of Raspberry Pi OS whos purpose is to host OctoPrint and to display it on a connected screen. TouchPrint is very customizable, and both the GUI and/or OctoPrint can be disabled if you already have an existing setup to perform those tasks.

Table of Contents

Screenshots

TODO

Requirements

Minimum:

  • Raspberry Pi 3
  • 8GB microSD card
  • Keyboard and video for first time setup

Recommended:

  • Raspberry Pi 4
  • 8GB Class 10 microSD card
  • Keyboard and video for first time setup

Quick Setup Guide

Flashing on Windows/Mac OS/Linux (Easy)

  1. Download and install balenaEtcher.
  2. Download the latest image from the releases section.
  3. Follow the on screen instructions in Etcher to burn the image to your microSD or USB drive.

Flashing in Mac OS/Linux/BSD (Recommended)

  1. Download the latest image from the releases section.

  2. Open a terminal and navigate to where you downloaded the image file.

  3. Ensure that xz is installed on your computer.

    OS Command
    Ubuntu/Debian apt install xz-utils
    Arch/Manjaro pacman -S xz
    Mac OS brew install xz

  4. Run xz -d -c IMAGE_NAME.img.xz | sudo dd of=/dev/sdX, replacing IMAGE_NAME and /dev/sdX with the appropriate paths, and adding flags per your preferences.

First Boot

  1. Connect an HDMI cable and a keyboard to your Raspberry Pi.
  2. Power on your Raspberry Pi and wait for it to boot.
  3. Once booted, you will be put into the first time setup, where you can configure networking, choose which services you want to run, etc.
  • Use the arrow keys to move the "cursor", Spacebar to toggle checkboxes, Tab to move the cursor between different sections, and Enter to continue.
  1. Once the first time setup is complete, the Raspberry Pi will reboot.

OctoPrint Setup

  • If the GUI is enabled, you can setup OctoPrint on the Raspberry Pi. You can also setup OctoPrint by opening up a web browser on another computer and navigating to https://RPI-IP, replacing RPI-IP with the IP address of your Raspberry Pi.
  • If MJPG-Streamer is enabled, you can put /webcam into the Stream URL box to enable it in OctoPrint.
  • If you wish to enable timelapses, the path to ffmpeg is /usr/bin/ffmpeg.

Accessing OctoPrint

  • If OctoPrint is enabled, you can access it at https://RPI-IP, replacing RPI-IP with the IP address of your Raspberry Pi.

Configuring TouchPrint

  • TouchPrint can be configured either over SSH or in a TTY using the octo-config script. This script is provided to make management of core features easier and to consolidate TouchPrint's settings into one place.
  • OctoPrint can be configured through the OctoPrint UI as normal.

Reporting Bugs

Please report any bugs by filing an issue. Please include as much detail as you can, including (but not limited to):

  • Raspberry Pi Model
  • Version of TouchPrint
  • What you were doing when the bug/issue occured
  • Steps to reproduce
  • Logs