Off-Grid Music Player

Quick Navigation

• Play music from iTunes / Apple Music library
• Copy music via built-in web server
• Play music from iCloud Drive
• Copy music from USB via Files app
• Copy music from SMB via Files app
• Why correct ID3 tags matter
• Create playlists
• Delete item from playlist
• Play Next
• Add to Queue
• AirPlay
• Troubleshooting

Privacy and Contact

• Click here to view Privacy Policy
• Contact: [email protected]

Play Music from iTunes / Apple Music Library

1. Open Settings.
2. Turn on Include iTunes Library.
3. If prompted, allow media library access.
4. Tap Refresh Library (or wait for automatic refresh after toggling).
5. Go to Songs, Albums, or Artists, then start playback.

Notes

• Import includes tracks with accessible local/media URLs.
• You can import Apple Music playlists from Playlists using the top-right import button when iTunes library is enabled.

Copy Music via Built-in Web Server

1. Open Settings -> File Upload.
2. Keep this screen open. The server runs only while this screen is visible.
3. On another device on the same Wi-Fi, open the shown Address in a browser.
4. Enter the shown Username and Password.
5. Upload files or folders from the browser page.
6. After upload finishes, the app refreshes library indexing.

Important

• Credentials are randomly generated each app run.
• Uploaded files go to the app Documents Music folder.

Play Music from iCloud Drive

Method A: Add iCloud folder as a library source

1. Open Settings.
2. Ensure Include Files and Folders is on.
3. Tap Add music folder.
4. In the Files picker, choose a folder in iCloud Drive.
5. The app stores access and refreshes the library.

Method B: Copy from iCloud Drive into app storage

1. In the Files app, copy tracks from iCloud Drive to On My iPhone app storage.
2. Return to the app and tap Refresh Library.

Note

• If an iCloud file is not downloaded locally yet, indexing may skip it until downloaded.

Copy Music from USB via Files App

1. Connect USB storage to iPhone or iPad using an adapter if needed.
2. Open Apple Files app.
3. Copy tracks or folders from USB to a local or app-accessible folder.
4. In this app, either add that folder with Settings -> Add music folder, or keep files in the app default Music folder.
5. Tap Refresh Library.

Copy Music from SMB via Files App

1. In Apple Files, connect to SMB using the ... menu, then Connect to Server.
2. Copy tracks or folders from SMB to local or app-accessible storage.
3. In this app, use Settings -> Add music folder to include that folder.
4. Tap Refresh Library.

Tip

• Copying locally is usually more reliable than playing directly from network shares.

Why Correct ID3 Tags Matter

The app indexes metadata and uses it for browsing and playback behaviour.

Recommended tags

• Title
• Artist
• Album
• Track Number
• Genre
• Embedded Artwork (optional, recommended)

What happens if tags are missing

• Missing title: file name is used.
• Missing artist or album: Unknown Artist / Unknown Album.
• Missing track number: album ordering is less accurate.

Good tags improve browsing, album order, playlist quality, and autoplay selection.

Create Playlists

From any song list such as Songs, Albums, Artists, playlist detail, or queue:

1. Long-press a song.
2. Tap Add to Playlist.
3. Choose an existing playlist, or tap Create New Playlist....

From the Playlists screen:

• Open Playlists to view and manage playlists.
• If iTunes library import is enabled, import playlists from Apple Music or iTunes.

Delete Item from Playlist

1. Open Playlists.
2. Open a playlist.
3. Swipe left on a song.
4. Tap Delete.

This removes the song from the playlist only. It does not delete the media file.

Play Next

1. Long-press a song.
2. Tap Play Next.

Behaviour

• Inserts the track immediately after the current track.
• Preserves the rest of the queue order.

Add to Queue

1. Long-press a song.
2. Tap Add to Queue.

Behaviour

• Appends the track to the end of the current queue.

AirPlay

1. Open the Now Playing controls.
2. Tap the AirPlay button.
3. Select an AirPlay target such as a speaker, TV, or device.

Troubleshooting

• New files not visible: Settings -> Refresh Library.
• iTunes tracks missing: verify Include iTunes Library is on and media permission is allowed.
• iCloud tracks missing: download locally first, then refresh.
• Upload not working: ensure both devices are on the same Wi-Fi and the File Upload screen stays open.