Table of Contents

Building a new Folk installation from scratch? You'll need some ingredients:

TODO: Make a matrix for small, medium, and large/sunlit installations (in which case you'll want the Epson 1080p & a beefy Beelink). In all cases, base OS is Ubuntu Server 23.10, though point out it can be Virtual Machine hosted with QEMU. Save the QEMU process in a new page (/guides/virtualizing-folk)

Hardware

TODO: <Picture of all the folk-cwe hardware, annotate it with 1, 2, 3, 4, etc.>

Computer hardware:

  1. Beeline Mini S
  2. Logitech K360 Compact Wireless Keyboard and Mouse combo
  3. Printer, pictured here is the smallest & cheapest option, good only for very small instances (camera coverage of ~5 square feet) — the Bluetooth Cat Printer (Amazon link)
    1. If you'll be printing a lot and want a more robust sprinter that still fits on a desk, try the Epson EC-110
  4. AAXA P400 projector, very dim so also only suitable for these small installations

Mounting hardware:

  1. Quick support tension rod for mounting without screwing into the ceiling
  2. Mini mounting arm for camera
  3. Clip with 1/4" screw for mounting the P400

The lifecycle of this hardware:

Required: Beelink/computer, projector, camera, all mounting hardware Set-up only: Bluetooth keyboard and mouse

Technically, you can remove the keyboard and mouse (e.g. if you only have a wired USB keyboard) after installing Folk. In practice we've found that you'll want a Bluetooth keyboard with a USB dongle in the machine because that's:

  1. a reliable wireless connection to the machine
  2. We support Alt + Esc' for restarting Folk if anything goes wrong. Unless you're developing Folk itself or writing unsafe (C, Tcl w/ shell commands, or complex shaders) you won't need this functionality.
  3. It's also nice to have an in-system editor by attaching an editor program to you keyboard.