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

# 음악

> Mac의 Spotify나 Apple Music에서 나오는 곡을 보고 조작하고, 에이전트에게 틀어 달라고 합니다.

음악은 Mac의 음악 앱, Spotify와 Apple의 음악 앱을 보여 주고 조작합니다. 스스로 스트리밍하지 않으며 계정이나 키가 필요 없습니다. Archetype에 포함되어 있고 처음부터 켜져 있습니다. macOS에서만 동작합니다. 플러그인 전반은 [플러그인](https://docs.archetype.ing/ko/extend/plugins.md)을 참고하세요.

## 사이드바

**음악**에는 지금 나오는 곡과 앨범 아트, 재생 위치, 조작 버튼, 음량, 그리고 설치된 앱 사이를 오가는 전환이 있습니다.

* **Spotify**: Spotify 링크를 붙여넣어 틀거나 검색합니다.
* **Apple Music**: 보관함에서 곡을 찾고 플레이리스트를 틉니다.

화면을 보고 있는 동안 2초마다 앱을 읽습니다. 앱이 닫혀 있으면 오류가 아니라 열려 있지 않다고 보여 줍니다.

## 앱 조작 허용

처음에 macOS가 Archetype이 Spotify나 음악 앱을 조작해도 되는지 묻습니다. 허용합니다. 전에 거절했다면 **시스템 설정 → 개인정보 보호 및 보안 → 자동화 → Archetype**에서 그 앱을 켭니다. 허용되지 않았으면 화면에 이 단계가 나옵니다.

## 에이전트가 하는 일

| 도구 | 하는 일 |
| - | - |
| `now_playing` | 지금 어디서 무엇이 나오는지 봅니다. 읽기만 합니다. |
| `search_music_library` | 음악 보관함에서 곡을 찾습니다. 읽기만 합니다. |
| `list_music_playlists` | 음악 앱의 플레이리스트를 봅니다. 읽기만 합니다. |
| `control_music` | 재생, 일시 정지, 다음, 이전, 위치 이동, 음량, 셔플, 반복. |
| `play_music` | Spotify 링크, 음악 앱의 곡이나 플레이리스트를 틉니다. |

`control_music`과 `play_music` 앞에 플러그인이 따로 묻지는 않습니다.

## 설정

| 설정 | 하는 일 |
| - | - |
| **Music app** (`player`) | 둘 다 재생하지 않을 때 화면에 보일 앱입니다. `auto`, `spotify`, `music` 중 하나입니다. 하나가 재생 중이면 그 앱을 보여 줍니다. |

`~/.config/archetype/config.json`에서도 정합니다. `"plugins": { "music": { "player": "spotify" } }`

## 끄기

**관리 → 플러그인**에서 끄거나 `"plugins": { "music": false }`를 둡니다.


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