Support

Help for every Yolo client: the player in a browser (a Tesla's browser or any other), Yolo TV for Apple TV, and the clients that come next.

Get help. Report a bug or ask a question on GitHub Issues, or email support@useyolo.app. Please say which client and version you use and what you expected, and leave out tokens and credentials.

What you need

Yolo is self-hosted: the apps play from a Yolo server you run yourself, and come with no content. Before a screen can play anything you need:

A Cloudflare account. Workers Free covers one household.
A home machine that stays on (macOS or Linux), with Node.js 22.12 or newer, yt-dlp, ffmpeg, and Deno. It runs the media node, which reads your media.
A domain is optional: without one, Yolo runs on your account's free workers.dev address.

Deploy Yolo

The simplest way is to let an AI coding agent do it. Clone the repository on your home machine, open it in Claude Code or Codex, and ask it to deploy Yolo. It follows the yolo-deploy skill step by step and stops at each step only you can do:

Sign in to Cloudflare from any device, with a link and a code (npm run yolo -- auth).
Approve the plan: the Cloudflare resources it creates, and your address.
Create your passkey with the 6-digit code from npm run owner-code, at https://<your address>/login.
Pair your first screen (below) and, if you like, connect an agent such as Claude over MCP.

To upgrade later, ask the agent to follow the yolo-upgrade skill. To check an instance at any time, run npm run yolo -- doctor; every failing check comes with its fix.

Pair a screen

Every screen pairs once, with your passkey on your phone. Pairing codes last 10 minutes and work once.

A browser: a car, computer, or phone

Open your Yolo address in the browser. It shows a QR code and a short code.
Scan the QR code with your phone, sign in with your passkey, check the screen's name and type, and press Allow.
On a phone or computer where you are already signed in, you can approve the page's own code with one press instead.

Yolo TV on Apple TV

Open Yolo TV on an Apple TV on the same network as your home machine. If asked, allow local network access: that is how it finds your server.
When it finds your server, confirm it with one press. If it finds none, type your Yolo address.
Scan the QR code it shows with your phone, sign in with your passkey, and press Allow.

Common questions

Does Yolo TV work without my own server?

No. Yolo TV is a player for your own Yolo server, as other media-server apps are for theirs. It carries no content and plays only what your server offers.

Yolo TV does not find my server.

Check that the Apple TV and the home machine are on the same network and that the media node is running (npm run yolo -- doctor). If you declined local network access, allow it again in the Apple TV's Settings, or type your Yolo address instead; away from home, typing the address is the only way.

The pairing code expired.

Codes last 10 minutes. The screen asks for a new one; scan the new QR code.

Nothing plays, or it keeps buffering.

The media node on your home machine must be on and online. Run npm run yolo -- doctor on it and follow the fix for any failing check. At home, video plays straight from the node over your network; away, it uses the node's remote address or falls back to the relay through your Cloudflare account, and the player lowers quality when the connection is slow.

Where is the Ask button, or its microphone?

Ask appears when an agent plugin, such as Claude Code or Codex, is set up on your media node. The microphone in the browser player appears only when the node also has a transcription plugin. On Apple TV, use the Siri Remote's dictation.

I lost a device, or want to remove a screen.

Remove it in Yolo's settings, or ask your agent to. Its credential stops working at once and the screen returns to pairing.

I lost my passkey.

Run npm run owner-code on the home machine and sign in at https://<your address>/login within 15 minutes. A new code replaces all existing passkeys.

How do I share one video with a friend?

Use the share button in the player, or ask your agent. The link plays that one item in any browser for 7 days, and you can revoke it in Settings → Share links.

Does Yolo collect my data?

No. Everything stays in your own Cloudflare account and on your home machine. See the privacy policy.

Source code and security

Yolo is open source under the MIT license: github.com/HaitianLiu5/yolo. Report a security issue privately as its security policy describes, not in a public issue.