# Muse

> Muse is a tiny music player for macOS in the spirit of Winamp. It plays your own music files (MP3, AAC, ALAC, FLAC, WAV, AIFF), floats above other windows, shrinks to just the cover, lives in the menu bar, and changes its whole look with a skin: a single JSON file that you, or an AI agent, can write. It comes with a `muse` command-line tool so agents can install it, control playback, and create, check and preview skins.

Free. Requires macOS 14 (Sonoma) or later on Apple silicon. Install with: `curl -fsSL https://tinymuse.app/install.sh | sh`

## Install

- [Install guide for agents](https://tinymuse.app/install.md): requirements, the installer, checking it works, playing music, uninstalling
- [Installer script](https://tinymuse.app/install.sh): POSIX shell, no sudo; installs the app, the `muse` CLI and the agent skill
- [App download](https://tinymuse.app/download/Muse.zip): zipped Muse.app with a SHA-256 at https://tinymuse.app/download/Muse.zip.sha256

## Skins

- [Skin guide](https://tinymuse.app/skins.md): the skin.json format, layout nodes, colours, variables and examples
- [Agent skill: making skins](https://tinymuse.app/skills/muse-skins/SKILL.md): the create → validate → snapshot → apply loop for agents
- [Skin JSON Schema](https://tinymuse.app/skin.schema.json): exact types for every node and property
- [Example skin: Card](https://tinymuse.app/skins/Card.json)
- [Example skin: Default](https://tinymuse.app/skins/Default.json)
- [Example skin: Midnight](https://tinymuse.app/skins/Midnight.json)
- [Example skin: Mono](https://tinymuse.app/skins/Mono.json)
- [Example skin: Paper](https://tinymuse.app/skins/Paper.json)
- [Example skin: Pill](https://tinymuse.app/skins/Pill.json)
- [Example skin: Tape](https://tinymuse.app/skins/Tape.json)
- [Example skin: Turntable](https://tinymuse.app/skins/Turntable.json)

## Optional

- [Everything in one file](https://tinymuse.app/llms-full.txt): this page, the install guide, the command reference, the skin guide and the FAQ