HHostingByteSoftware
Ctrl K
ComunidadGuías…

README.md

Rama main · réplica de lectura del repositorio original.

Archivo original ↗Preguntar a KiBot
<p align="center">
  <img src="https://www.mobile-ma.app/img/appicon.png" width="120" alt="Mobile MA app icon">
</p>

<h1 align="center">Mobile MA</h1>

<p align="center">
  <strong>An unofficial, independent client for <a href="https://www.music-assistant.io">Music Assistant</a>.</strong><br>
  Not affiliated with, developed, endorsed or reviewed by the Music Assistant project or the Open Home Foundation.
</p>

<p align="center"><strong>Your music. Your server. Everywhere.</strong></p>

<p align="center">
  A native SwiftUI app that connects to your own Music Assistant server —
  on iPhone, iPad, Apple Watch, Apple TV and CarPlay.
</p>

<p align="center">
  <a href="https://apps.apple.com/app/id6761258120?pt=128697224&ct=github-readme&mt=8">Download on the App Store</a>
  ·
  <a href="https://www.mobile-ma.app/en/">Website</a>
  ·
  <a href="https://www.mobile-ma.app/changelog/">Changelog</a>
  ·
  <a href="https://github.com/apps4selfhosted/mobile-ma/releases">Releases</a>
  ·
  <a href="https://github.com/apps4selfhosted/mobile-ma/issues">Report an issue</a>
</p>

---

> Mobile MA is a community project by Sven Hanold. It is not part of the official Music Assistant
> project and not an Open Home Foundation product. "Music Assistant" is the name of their project and
> is used here only to say what this app connects to — with respect and thanks to the team that
> builds and maintains it. The official app and everything about the project:
> [music-assistant.io](https://www.music-assistant.io).

## Screenshots

<table>
  <tr>
    <td align="center"><img src="images/iphone-home.png" width="170" alt="Home screen with scenes and players"></td>
    <td align="center"><img src="images/iphone-nowplaying.png" width="170" alt="Now Playing with artwork and transport controls"></td>
    <td align="center"><img src="images/iphone-library.png" width="170" alt="Library grid of artists"></td>
    <td align="center"><img src="images/iphone-players.png" width="170" alt="Player overview with volume and grouping"></td>
    <td align="center"><img src="images/iphone-themes.png" width="170" alt="Theme picker with eight colour schemes"></td>
  </tr>
  <tr>
    <td align="center"><sub>Home</sub></td>
    <td align="center"><sub>Now Playing</sub></td>
    <td align="center"><sub>Library</sub></td>
    <td align="center"><sub>Players</sub></td>
    <td align="center"><sub>Themes</sub></td>
  </tr>
</table>

<table>
  <tr>
    <td align="center" colspan="2"><img src="images/carplay.png" width="360" alt="Now Playing on CarPlay"></td>
    <td align="center" colspan="2"><img src="images/ipad-library.png" width="300" alt="Library on iPad with sidebar"></td>
    <td align="center"><img src="images/watch-nowplaying.png" width="130" alt="Now Playing on Apple Watch"></td>
    <td align="center"><img src="images/watch-players.png" width="130" alt="Player list on Apple Watch"></td>
  </tr>
  <tr>
    <td align="center" colspan="2"><sub>CarPlay</sub></td>
    <td align="center" colspan="2"><sub>iPad</sub></td>
    <td align="center" colspan="2"><sub>Apple Watch</sub></td>
  </tr>
</table>

<sub>Artwork and track names in these screenshots are obscured or replaced with placeholders.</sub>

## What it does

Start music in any room, group your players, keep your stations close — from your phone,
in the car, on your wrist and on the TV. No cloud, no account, and it works away from home too.

**Players, groups and queue.** Every player on your server in one list, with type, status and
volume synced live. Group any speakers into a zone and start music everywhere at once. Save the
combinations you use often as a scene and recall them with a single tap. Add tracks, albums and
playlists to play next or at the end of the queue, hand the whole queue to another device
mid-track, or save it as a playlist.

**Access from anywhere.** Remote access opens a direct, encrypted WebRTC connection to your
server. No port forwarding, no VPN, and nothing of yours exposed to the open internet. Running
more than one server? Save them as named connection profiles and switch with one tap.

**CarPlay.** Your full library in the car — albums, artists, genres, tracks, playlists, podcasts,
audiobooks, radio and favourites, each with artwork. Search by voice or keyboard while driving.
CarPlay works even before you have opened the app on your iPhone.

**Apple Watch.** Browse players and see what's playing, artwork included. Play, pause and skip in
one tap, volume on the Digital Crown, favourite the current track and scrub through playback —
without reaching for your phone.

**Apple TV.** Music Assistant on the big screen: players, Now Playing with large artwork, library
browsing and search, all from the Siri Remote. Your iPhone hands over the server credentials with
a tap, so there is nothing to type during setup.

**Library, podcasts and radio.** A Discover home screen you arrange yourself, search that merges
results across providers and finds radio stations by name, and a Continue Listening section for
podcasts and audiobooks with variable speed and configurable skip intervals.

**AI Radio.** Turn your server into a radio station. Start AI Radio stations from the
Radio tab, or put an AI host on any queue — your library, Spotify or Tidal — who talks
between the tracks. Stations work in multi-room scenes and in CarPlay. Requires the
AI Radio plugin on your Music Assistant server (2.10.3 or newer).

**Your data stays yours.** Mobile MA talks only to the server you configured. No intermediary
service, no account, no sign-up, no third-party analytics or advertising SDKs. Credentials live
in the iOS Keychain and sync via iCloud between your own devices only.

## Requirements

- A running [Music Assistant](https://www.music-assistant.io) server
- iOS / iPadOS 18.6 or later · watchOS 10.0 or later · tvOS 17.0 or later
- Free download. Unlimited is a one-time purchase — no subscription.

## Support

This repository is the public place for bug reports and feature requests:

- 🐞 [Report a bug](https://github.com/apps4selfhosted/mobile-ma/issues/new?template=bug_report.yml)
- 💡 [Request a feature](https://github.com/apps4selfhosted/mobile-ma/issues/new?template=feature_request.yml)
- ❓ [Frequently asked questions](https://www.mobile-ma.app/en/faq/)

Prefer not to post publicly? The [support form](https://www.mobile-ma.app/en/support/) reaches the
same place privately. Replies usually within one to two days.

The app's source code is not hosted here — this repository exists for support, documentation and
releases.

## Related apps

Other native iOS clients for self-hosted services, by the same developer:
[dock-g](https://www.dock-g.app/) (Dockge) ·
[gyokuro](https://www.gyokuro.app/) (Gitea/Forgejo) ·
[BookStax](https://www.bookstax.app/) (BookStack) ·
[picaroa](https://www.picaroa.app/) (PicoShare) ·
[DockTrace](https://www.docktrace.app/) (Dozzle)

---

<p align="center">© 2026 Sven Hanold · Apps4Selfhosted</p>