Skip to content

Commit 655d928

Browse files
rxliuliclaude
andcommitted
docs: update YouTube Music Background Play README
- Expand feature description to include background browser support - Add Browser Support section with Safari compatibility info - Remove iOS Safari limitation (now supported) - Reorganize screenshot to end of document for better readability Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent a2f9cc6 commit 655d928

1 file changed

Lines changed: 15 additions & 4 deletions

File tree

  • src/plugins/youtube-music-background-play

src/plugins/youtube-music-background-play/README.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,20 @@
11
# YouTube Music Background Play
22

3-
A userscript that prevents YouTube Music from pausing playback when running in background tabs.
3+
A userscript that prevents YouTube Music from pausing playback when switching tabs or running the browser in the background.
44

55
## What it does
66

7-
This userscript intercepts browser APIs that YouTube uses to detect if you're actively watching, allowing music to continue playing when you switch to other tabs.
7+
This userscript intercepts browser APIs that YouTube uses to detect if you're actively watching, allowing music to continue playing when you:
88

9-
<img width="590" height="1280" alt="image" src="https://github.com/user-attachments/assets/c2bf18d7-fbdc-486f-9b68-5f0e3e966b3d" />
9+
- Switch to other tabs
10+
- Minimize the browser window
11+
- Switch to other applications
12+
13+
## Browser Support
14+
15+
- ✅ Chrome/Edge/Firefox - Full support
16+
- ✅ macOS Safari - Full support (requires Tampermonkey or Userscripts extension)
17+
- ✅ iOS Safari - Full support (requires Userscripts extension)
1018

1119
## Installation
1220

@@ -17,7 +25,6 @@ This userscript intercepts browser APIs that YouTube uses to detect if you're ac
1725

1826
- **Unstable**: YouTube may update their detection methods at any time, causing this userscript to stop working
1927
- **Computer sleep**: Playback will still pause when your computer goes to sleep or hibernates
20-
- **iOS Safari**: This userscript does not work on iOS Safari due to platform-specific restrictions
2128
- **Updates**: May break when YouTube updates their site
2229

2330
## How it works
@@ -33,6 +40,10 @@ The userscript overrides the following browser APIs:
3340

3441
This userscript is for personal use. Use at your own risk.
3542

43+
## Screenshot
44+
45+
<img width="590" height="1280" alt="iOS Safari Screenshot" src="https://github.com/user-attachments/assets/c2bf18d7-fbdc-486f-9b68-5f0e3e966b3d" />
46+
3647
## Discord
3748

3849
Join the discussion: <https://discord.gg/C2baQRZUCW>

0 commit comments

Comments
 (0)