Docs/Getting Started
Getting Started
Icoustic is a personal music system for files you already own — MP3, FLAC, and M4A. There is no streaming catalog and no account required to listen. Point each device at its own folders and Icoustic shows them together — one library you can play to any device.
What you need
- A Mac (macOS 15+), or an iPad or iPhone on iPadOS / iOS 26.5 or later
- A folder of DRM-free audio files on the device or in iCloud Drive
Install
Download Icoustic from the App Store for iPhone, iPad, and Mac.
First launch
- Open Icoustic.
- Add a music folder (see Adding a Library Folder).
- Wait for the first scan — large libraries take a few minutes; later rescans are much faster.
- Browse Albums or Songs, and press play. Artists and Genres are off until you turn them on in Settings → Display.
More than one device?
Open Icoustic on a second device on the same Wi‑Fi; it appears in the sidebar. Approve it there once (each side approves the other) and you can browse its shared folders, send music to it, or drive it from your pocket. See Devices & Networks.
Next steps
- Set up devices & networks
- Learn browsing & search
- Set up playback & queue
- On Mac, connect MCP for AI-assisted library work
- Give your AI the Icoustic skill
- Understand privacy & local-first