← Home

MusicLib syncs playlists and music files to Android or iOS devices via KDE Connect.

• Android: Google Play Store
• iOS: App Store (requires iOS 14+)

1. Open KDE Connect on both devices
2. Click Refresh to discover
3. Click your device name and accept pairing on both sides
4. Verify firewall allows port 1716

Settings → Mobile tab → enter your Device ID (shown in KDE Connect) → Save

1. Create the playlist in your MPRIS2 player (Audacious, Strawberry, etc.)
2. Ensure KDE Connect is active and paired on both devices
3. Mobile Panel → select playlist → select device → Upload

MusicLib will:

• Process the previous playlist's last-played accounting
• Convert the playlist to .m3u
• Transfer all track files via KDE Connect
• Record the upload timestamp

Since mobile devices can't report exact playback data, MusicLib synthesizes play history:

• The accounting window = time between playlist uploads
• Tracks in the old playlist receive synthetic timestamps distributed using an exponential distribution (earlier tracks get earlier timestamps)
• Tracks played via your MPRIS2 player on the desktop during that window receive their real timestamps instead

This gives your smart playlist meaningful play history even for mobile listening.

# Upload a playlist
musiclib-cli mobile upload workout

# Upload to a specific device
musiclib-cli mobile upload workout abc123def456

# Backdate the accounting window
musiclib-cli mobile upload workout --end-time "02/15/2026 21:00:00"

# Check current mobile status
musiclib-cli mobile status

# View logs
musiclib-cli mobile logs
musiclib-cli mobile logs errors
musiclib-cli mobile logs today

# Retry failed last-played updates
musiclib-cli mobile retry workout

# Clean up orphaned metadata
musiclib-cli mobile cleanup

Due to Apple restrictions:

• File access is more limited than Android
• Playback tracking has reduced precision
• Transfers may be slower

Core functionality (upload, last-played accounting) works the same.