Help for your listening room.

Authorization, catalog, and personal library

Authorize access

1. Open Settings in MusicMall.
2. Find Apple Music and choose the authorization action.
3. Approve the iOS prompt.
4. Return to MusicMall to see authorization and playback eligibility.

Authorization does not guarantee catalog playback. Catalog streaming requires an eligible subscription, network access, and continued availability. MusicMall never asks for an Apple Account password.

Browse the catalog

1. Open My Collection and select the Apple Music Catalog search scope.
2. Search for an artist or album.
3. Open an artist or album to see details and tracks.
4. Choose Add to My Collection.

Adding an album stores identifiers, metadata, artwork, and MusicMall customizations. It does not download Apple Music streaming audio.

Personal iPhone Music Library

Open Settings → Apple Music → iPhone Music Library to browse Albums, Artists, and Songs. Eligible purchased or computer-synced media may work without a catalog subscription. Cloud-only, protected, unavailable, or inaccessible items may not play.

Import from Files

1. Open Settings.
2. Use Open Files for an album folder, or Scan Local Audio Files → Choose Folder to Scan for a larger artist folder.
3. Select the folder in Apple's Files picker.
4. Keep the storage provider available while MusicMall scans.
5. Find imported albums in My Collection.

MusicMall supports common compatible formats including MP3, M4A, AAC, WAV, FLAC, and ALAC. Keep each album's tracks and artwork together. If access later expires, reconnect the provider and select the folder again.

Other transfer methods

• Wi-Fi Transfer: send files or folders from a computer browser on the same trusted network.
• File Sharing/Cable Transfer: copy files through Finder, then scan MusicMall files.
• AirDrop/Open In: send compatible files to MusicMall.

My Collection, Side A, and Side B

Open an album to inspect tracks, choose a song, and use available vinyl customization. MusicMall splits tracks into Side A and Side B. For supported sources, the end of Side A continues through MusicMall's flip behavior to the first track on Side B. The final track on Side B stops without wrapping to Side A.

The album sleeve can flip between front and back. A valid back cover appears when available; otherwise MusicMall can generate a back presentation from the front artwork and Side A/Side B track list. Removing an album from My Collection removes its MusicMall record, not the original file in Files or content from Apple Music.

Add or replace lyrics

When a song has no lyrics

1. Start or select the song.
2. Open Lyrics in Now Playing.
3. Tap Add Lyrics.
4. Choose an .lrc or .txt file in Files.
5. The lyrics stay associated with the selected song after reopening MusicMall.

Replace existing lyrics

1. Open the song's Lyrics view.
2. Tap the ••• menu.
3. Choose Add Lyrics.
4. Select the replacement file and confirm replacement.

A valid LRC file can show synchronized lyrics using timestamps. A TXT file displays plain text without timed highlighting. Select only lyrics you have permission to use. MusicMall Public does not search LRCLIB or NetEase online.

Wi-Fi Transfer

1. Connect the iPhone and computer to the same trusted Wi-Fi network.
2. Open Settings → Wi-Fi Transfer.
3. Turn the server on and allow Local Network access if iOS asks.
4. Open the local address displayed by MusicMall in the computer browser.
5. Enter the temporary pairing code.
6. Choose files or an album folder and upload them.
7. Keep the browser and transfer screen open until transfer and scanning finish.
8. Turn Wi-Fi Transfer off when finished.

Each uploaded file is limited to 512 MB and failed pairing attempts are temporarily limited. Wi-Fi Transfer uses plain HTTP, not encrypted HTTPS. Use it only on a trusted private network and never share the pairing code.

If the page does not open, verify both devices use the same non-isolated network, allow Local Network access for MusicMall and the computer browser, keep the transfer screen open, and avoid guest Wi-Fi that blocks device-to-device traffic.

Lock Screen, widget, and External Audio

During supported playback, MusicMall publishes track information and controls to iOS. The Home Screen widget reads a small local snapshot shared with the app; it does not contain a separate audio engine. If widget information is stale, open MusicMall, select or start the intended album, then allow WidgetKit time to refresh.

External Audio Settings selects a supported file or folder for the exterior or ambient experience; it is not an album import. If the source moves or loses permission, select it again. Starting main album playback should stop incompatible ambient audio.

Common problems