Music Player

A native iOS music player that automatically scans and plays music files from your device's Documents folder.

Features

• 🎵 Automatic Music Discovery: Scans Documents folder and iCloud Drive for music files
• 🎛️ Full Playback Controls: Play, pause, next, previous with shuffle and repeat modes
• 📱 Native iOS Integration: Works with Control Center and lock screen
• 🌍 Multi-language Support: English, Russian, Spanish, Thai, Chinese
• 🔄 Background Scanning: Automatically detects new files every 30 seconds
• 📋 Smart Sorting: Sort by title, artist, date added, or duration
• 🎨 Beautiful UI: Clean, modern interface optimized for iPhone and iPad

Supported Formats

• MP3 (.mp3)
• WAV (.wav)
• AAC (.aac, .m4a)
• FLAC (.flac)
• OGG (.ogg)
• AIFF (.aiff)
• CAF (.caf)
• M4P (.m4p)
• WMA (.wma)
• Opus (.opus)

How to Add Music Files

Method 1: Documents Folder (Recommended)

1. Open Files app on your iPhone/iPad
2. Navigate to On My iPhone → Music Player
3. Copy your music files into this folder
4. Files will be automatically detected and added to your library

Method 2: Manual Addition

1. In the Music Player app, tap the + button
2. Select "Local File" option
3. Choose music files from your device

Method 3: Online Streams

1. Tap the + button in the app
2. Select "Online" option
3. Enter a direct URL to an audio stream

Playback Controls

• Play/Pause: Tap the center button or any track
• Next/Previous: Use arrow buttons or swipe
• Shuffle: Tap shuffle button for random playback
• Repeat: Cycle through repeat modes with the mode button

Sorting Options

Tap the sort button (↕️) in the top-left corner to sort by:

• Title: Alphabetical by song name
• Artist: Alphabetical by artist name
• Date Added: By when files were added
• Duration: By song length

Background Playback

The app supports background playback and can be controlled from:

• Lock screen
• Control Center
• Connected headphones/remote controls

Automatic Scanning

The app automatically scans for new music files:

• When the app starts
• When returning from background
• Every 30 seconds in the background
• Manually with the refresh button

Requirements

• iOS 16.0 or later
• Storage access for Documents folder
• Optional: iCloud Drive for cloud sync

Troubleshooting

No Music Files Found

• Check that files are in the Documents folder
• Supported formats: MP3, WAV, AAC, M4A, FLAC, OGG
• Try the manual "Add Files" option

Files Not Playing

• Check file permissions in Settings → Privacy → Files
• Ensure files are not corrupted
• Try restarting the app

iCloud Files Not Syncing

• Check iCloud Drive settings
• Ensure iCloud is enabled for the device
• Files in iCloud may take time to download

Technical Details

• Built with SwiftUI and AVFoundation
• Supports all iOS devices (iPhone, iPad, iPod touch)
• Optimized for iOS 16+ with modern concurrency
• Uses Core Data for track persistence
• Implements proper memory management for large music libraries

---

Made with ❤️ in MediaRise.org