> ## Documentation Index
> Fetch the complete documentation index at: https://docs.requestplus.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Music (Pear)

> Connect Request+ to YouTube Music using Pear Desktop.

Request+ integrates with YouTube Music through the [Pear Desktop](https://github.com/th-ch/youtube-music) client, which exposes a local API bridge that Request+ uses to read and control playback.

## Setup

<Steps>
  <Step title="Install Pear Desktop">
    Download and install Pear Desktop (the YouTube Music desktop client) from its [releases page](https://github.com/th-ch/youtube-music/releases).
  </Step>

  <Step title="Enable the API server plugin">
    In Pear Desktop, open **Settings → Plugins** and enable the **API Server** plugin. Confirm the port matches the one Request+ expects (default `26538`).
  </Step>

  <Step title="Select YouTube Music in Request+">
    In Request+, open **Settings → Music → YouTube Music**. After selecting the platform, YouTube Music will show the following prompt by default. 

    <Frame>
      <img src="https://mintcdn.com/daytrack/tzGtojGJhe4h4lXH/images/auth-yt-request.png?fit=max&auto=format&n=tzGtojGJhe4h4lXH&q=85&s=b2283015b08e428eea691c8d1461e1e7" alt="Image" width="342" height="158" data-path="images/auth-yt-request.png" />
    </Frame>

    Click "**Allow**" to give Request+ a API token for the YouTube Local API
  </Step>

  <Step title="Play a track">
    Start playback in Pear Desktop. Request+ should pick up the track and display it in the Now Playing panel and overlay.
  </Step>
</Steps>

## Supported actions

* Play / pause
* Skip / previous
* Seek
* Volume
* Shuffle / repeat
* Like / dislike
* Queue requested tracks

## Troubleshooting

<AccordionGroup>
  <Accordion title="Request+ can't connect">
    Make sure the **API Server** plugin is enabled and Pear Desktop is running. Check your firewall isn't blocking localhost connections on the configured port.
  </Accordion>
</AccordionGroup>

<Accordion title="Tracks don't queue">
  Some video-only results aren't queueable. Use song results (with the music note icon) where possible.

  <Note>
    You can check for videos at [https://music.youtube.com](https://music.youtube.com) or going to YouTube's main site and looking at the video objects, if they show the music icon, they are compatible. The top is one that works and the bottom shows the wrong type of video.
  </Note>

  <Frame>
    <img src="https://mintcdn.com/daytrack/ofZCAn0SWF2jfNnK/images/music_icon_example.png?fit=max&auto=format&n=ofZCAn0SWF2jfNnK&q=85&s=ffac6911307295167ff8c723b3aa9f26" alt="Music Icon Example" className="mr-auto" width="505" height="290" data-path="images/music_icon_example.png" />

    <img src="https://mintcdn.com/daytrack/tzGtojGJhe4h4lXH/images/music-not-icon-example.png?fit=max&auto=format&n=tzGtojGJhe4h4lXH&q=85&s=234bf418d968e1a64a0456da8b263de4" alt="Image" title="Image" className="ml-auto" width="526" height="314" data-path="images/music-not-icon-example.png" />
  </Frame>
</Accordion>