Home

Orchard Wiki

Orchard is an open-source, unofficial YouTube Music client for the desktop, with a standalone native Android companion app. It signs in through an embedded browser session and uses browser-backed InnerTube requests to reach YouTube Music.

Orchard is not affiliated with or endorsed by YouTube or Google.

This wiki is the long-form documentation. The README is the short version.

Start here

If you want to	Read
Install Orchard on your machine	Installation
Get through first launch and sign-in	Getting Started
Know what every setting does	Settings Reference
Fix something that broke	Troubleshooting
Understand how the code fits together	Architecture
Build it yourself	Building from Source

Features

• Playback and Queues covers shuffle, repeat, autoplay, queue persistence, and the sleep timer.
• Explicit and Age-Restricted Tracks explains how Orchard plays age-gated songs that most YouTube Music clients cannot.
• Best Mix explains how Orchard reorders a queue by tempo and key.
• Smart Crossfade is the beat-matched transition engine, in depth.
• Audio Engine covers the equalizer, automatic EQ, per-track gain, output routing, and the spectrum view.
• Song Cache covers on-disk caching and prefetching.
• Library and Discovery covers home, search, pins, Release Radar, personalized radio, podcasts, lyrics, and live shows.
• Replay is Orchard's local listening statistics.
• Listening Parties is synchronized peer-to-peer playback.
• Orchard Connect is LAN device pairing and handoff.
• Integrations covers Discord, Last.fm, Spotify, and YouTube history.
• Appearance covers themes, immersive backgrounds, and layout presets.
• Artist Packs covers installable custom artist pages.

Platforms

• Orchard Mobile is the native Android client.
• Orchard Mobile Settings documents every mobile option.
• Offline Downloads covers keeping tracks permanently on the phone.
• Orchard Mobile Architecture covers the mobile internals.

Developing

• Architecture
• Building from Source
• Cloudflare Workers
• Native Audio Analyzer
• Releases and Updates
• Contributing

Policy

• Privacy and Data
• License and Legal
• FAQ

Getting help

Public bug reports and feature requests belong in the Issues tab. Private reports, with optional diagnostics and screenshots, can be filed from Orchard's in-app Support System, which creates a conversation you can follow inside the app.