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

# Music

> See and control what Spotify or Apple Music plays on your Mac, and have the agent play what you ask for.

Music shows and drives the music apps on your Mac: Spotify and Apple's Music. It streams nothing itself and needs no account or key. It comes with Archetype and is on by default. It works on macOS only. General setup is in [Plugins](https://docs.archetype.ing/en/extend/plugins.md).

## In the sidebar

**Music** shows what is playing, with its artwork, a seek bar, the controls and the volume, and a switch between the apps you have installed.

* **Spotify**: paste a Spotify link to play it, or search.
* **Apple Music**: search your library and play your playlists.

The page reads the apps every 2 seconds while you look at it. A closed app is shown as not open, not as an error.

## Allow Archetype to control the apps

The first time, macOS asks whether Archetype may control Spotify or Music. Allow it. If you said no before, open **System Settings → Privacy & Security → Automation → Archetype** and turn on the app. The page shows these steps when it is not allowed.

## What the agent can do

| Tool | What it does |
| - | - |
| `now_playing` | What plays now, and where. Read only. |
| `search_music_library` | Finds songs in your Music library. Read only. |
| `list_music_playlists` | Lists your Music playlists. Read only. |
| `control_music` | Play, pause, next, previous, seek, volume, shuffle, repeat. |
| `play_music` | Plays a Spotify link, a Music song or a Music playlist. |

The plugin asks nothing of its own before `control_music` or `play_music`.

## Settings

| Setting | What it does |
| - | - |
| **Music app** (`player`) | The app the page shows when neither plays: `auto`, `spotify` or `music`. While one plays, the page shows that one. |

Or in `~/.config/archetype/config.json`: `"plugins": { "music": { "player": "spotify" } }`.

## Turn it off

Turn it off in **Manage → Plugins**, or set `"plugins": { "music": false }`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.