Skip to content

Commit 103e23c

Browse files
committed
docs: explain Background Sound downloads
1 parent 4bbcb43 commit 103e23c

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

README.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,14 @@ TMU supports multiple persistent, user-named Playlists. Press uppercase `P` outs
1515

1616
YouTube Cache is the only current Provider. TMU keeps a narrow internal Provider boundary for listing/searching Tracks and resolving local playback, as documented in [`docs/adr/0001-keep-narrow-provider-abstraction.md`](docs/adr/0001-keep-narrow-provider-abstraction.md).
1717

18+
## macOS Background Sounds
19+
20+
On macOS 26.5 and newer, TMU can control Apple's Background Sounds from the optional `Background` tab. The tab can enable or disable Background Sounds, select an immediately usable sound, and adjust its independent volume without affecting TMU playback.
21+
22+
TMU does not download Apple's Background Sound assets. Before selecting a sound in TMU, open macOS **System Settings → Accessibility → Audio → Background Sounds** and download it using Apple's native interface. Return to TMU and press `u` in the `Background` tab to refresh the available sounds. Sounds that have not been downloaded do not appear in TMU's picker.
23+
24+
Background Sounds remain owned by macOS rather than TMU: their enabled state, selected sound, and volume are shared with System Settings and are not saved in TMU's configuration.
25+
1826
## YouTube URL Download
1927

2028
YouTube URL Download stores downloaded audio in the YouTube Cache without adding it to any TMU Playlist. Users are responsible for downloading and keeping only content they have the right to download and keep.

0 commit comments

Comments
 (0)