> ## 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.

# Música

> Mira y controla lo que suena en Spotify o Apple Music en tu Mac, y haz que el agente ponga lo que le pidas.

Música muestra y maneja las apps de música de tu Mac: Spotify y la app Música de Apple. No reproduce nada en streaming por sí misma y no necesita cuenta ni clave. Viene con Archetype y está activado por defecto. Solo funciona en macOS. La configuración general está en [Plugins](https://docs.archetype.ing/es/extend/plugins.md).

## En la barra lateral

**Música** muestra lo que suena, con su carátula, una barra de progreso, los controles y el volumen, y un selector entre las apps que tienes instaladas.

* **Spotify**: pega un enlace de Spotify para reproducirlo, o busca.
* **Apple Music**: busca en tu biblioteca y reproduce tus listas.

La página lee las apps cada 2 segundos mientras la miras. Una app cerrada se muestra como no abierta, no como un error.

## Permitir que Archetype controle las apps

La primera vez, macOS pregunta si Archetype puede controlar Spotify o Música. Permítelo. Si antes dijiste que no, abre **Ajustes del Sistema → Privacidad y seguridad → Automatización → Archetype** y activa la app. La página muestra estos pasos cuando no tiene permiso.

## Qué puede hacer el agente

| Herramienta | Qué hace |
| - | - |
| `now_playing` | Qué suena ahora y dónde. Solo lectura. |
| `search_music_library` | Busca canciones en tu biblioteca de Música. Solo lectura. |
| `list_music_playlists` | Lista tus listas de Música. Solo lectura. |
| `control_music` | Reproducir, pausar, siguiente, anterior, saltar a un punto, volumen, aleatorio, repetir. |
| `play_music` | Reproduce un enlace de Spotify, una canción de Música o una lista de Música. |

El plugin no pregunta nada por su cuenta antes de `control_music` o `play_music`.

## Ajustes

| Ajuste | Qué hace |
| - | - |
| **Music app** (`player`) | La app que muestra la página cuando no suena ninguna: `auto`, `spotify` o `music`. Mientras suena una, la página muestra esa. |

O en `~/.config/archetype/config.json`: `"plugins": { "music": { "player": "spotify" } }`.

## Desactivarlo

Desactívalo en **Gestionar → Plugins**, o pon `"plugins": { "music": false }`.


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