> For the complete documentation index, see [llms.txt](https://docs.amee.thiennguyen.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.amee.thiennguyen.dev/features/now-playing.md).

# Now Playing

Amee shows whatever's currently playing anywhere on your Mac — Music, Spotify, a browser tab, any app that reports now-playing info to macOS — with title, artist, album, artwork, playback position, and play/pause/next/previous/seek controls, all from the floating mini player.

No extra permission prompt is needed for this — it works out of the box.

## Playback controls

Use the mini player's transport controls to play, pause, skip to the next/previous track, or seek to a position in the current track. These send the same commands as clicking play/pause inside whatever app is actually playing.

**Bringing the source app to the foreground** — some skins offer a button to jump straight to whichever app is currently playing (launching it first if it isn't already running). A toggle variant is also available: if the now-playing app is already frontmost, it jumps back to whatever app you were in before, so repeated presses switch back and forth. See `openNowPlayingApp()` and `toggleNowPlayingApp()` in the [SDK reference](/customization/sdk-reference.md).

**Always return to the app I toggled from** (Dashboard → General → Mini player) controls what "back" means after you've toggled to the now-playing app. Off (default): if you manually switch to some other app in between, the next toggle treats that as a fresh switch. On: the toggle always returns you to the original app you toggled *from*, even if you've been somewhere else since.

## Auto-hide when idle

Turning on **Auto hide when not playing** (Dashboard → General → Mini player) makes the floating mini player hide itself after 10 seconds of nothing playing, and reappear the moment playback resumes. Hovering the mini player or clicking into it restarts that countdown rather than cancelling it, so parking your cursor over an idle player keeps it visible — it still hides a little after you actually look away. Manually showing or hiding it from the menu-bar icon is remembered separately, so this feature never silently undoes a manual choice.

Skins can register callbacks for these transitions: `amee.onShow(cb)` fires when the mini player becomes visible again (playback resumed, tray icon clicked), and `amee.onHide(cb)` fires right before the window actually hides — giving a skin time to prime its own UI for a clean reappearance. A skin can also hide the mini player itself by calling `amee.hide()`. See the [SDK reference](/customization/sdk-reference.md).

## Auto-pause on quit

**Auto pause currently playing music when app quits** (on by default, Dashboard → General → App) sends a pause command to whatever's playing right before Amee exits — so quitting Amee doesn't leave music running behind a closed app by surprise.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.amee.thiennguyen.dev/features/now-playing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.