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: ====

  - Beeline Mini S
  - [[https://www.logitech.com/en-us/products/combos/mk360-compact-keyboard-mouse.920-003376.html|Logitech K360 Compact Wireless Keyboard and Mouse combo]]
  - Printer, pictured here is the smallest & cheapest option, good only for very small instances (camera coverage of ~5 square feet) — [[https://hackspace.raspberrypi.com/articles/bluetooth-cat-thermal-printer-review|the Bluetooth Cat Printer]] ([[https://www.amazon.com/Printer-Portable-Compatible-Bluetooth-Wireless/dp/B09KZR533K|Amazon link]])
    - If you'll be printing a lot and want a more robust sprinter that still fits on a desk, try [[https://epson.com/For-Work/Printers/Inkjet/WorkForce-EC-C110-Wireless-Mobile-Color-Printer/p/C11CH25202|the Epson EC-110]]
  - [[https://aaxatech.com/store/products/P400_mini_projector_store.html|AAXA P400]] projector, very dim so also only suitable for these small installations

==== Mounting hardware: =====

  - [[https://www.amazon.com/dp/B000CRDD6Y|Quick support tension rod]] for mounting without screwing into the ceiling
  - [[https://www.amazon.com/dp/B06VYCVVVJ|Mini mounting arm for camera]]
  - [[https://www.amazon.com/dp/B00DJ5XH4O|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:

  - a reliable wireless connection to the machine
  - 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.
  - It's also nice to have an in-system editor by attaching an ''editor'' program to you keyboard.