Welcome to Feral File Docs

This is the technical documentation for Feral File tools and protocol.

• What this is: docs for FF1 workflows, DP-1 integration, and supporting API/agent usage.
• Why use it: get from setup to trusted playback quickly.
• What to do next: choose one start path below.

Canonical protocol truth for DP-1 lives in display-protocol/dp1 (current spec v1.1.0).

Choose your start

• I want to build playlists and play them on FF1
• Start with FF1 CLI: Start Here
• I want to integrate DP-1 into my own systems
• Start with DP-1: Start Here (Integrators)
• I am setting up LLM tools
• Start with LLM & Agents Quickstart

Product map

• FF1 is the art computer and reference hardware.
• DP-1 is the open, vendor-neutral protocol.
• LLM / Agents is a support layer that helps you call APIs and tools; it does not replace FF1 CLI or DP-1 docs.

Next step

Open one start page above and complete the first success flow.