adeeteya/Classipod

Available for Android, iOS, macOS, Windows, Linux and web. Native apps support local music and server streaming. The web app plays demo songs or connects to your server; it does not import local folders.

Local files play offline. Server music requires your own compatible server, an account on that server, and a network connection. ClassiPod does not include a music subscription, offline server downloads, or server playlist syncing.

• 🌐 Stream from Subsonic-compatible servers such as Navidrome through Settings → Library Settings → Subsonic.
• 🏠 Combine local and server tracks, or use Hide Local Music while streaming.
• 🧑‍🎤 Browse songs, artists, album artists, albums, and genres.
• 🔍 Search songs, artists, albums, and your ClassiPod playlists.
• 📂 Discover Android music through MediaStore. Select a parent music folder on iOS, macOS, Windows, or Linux and scan its subfolders automatically.
• ⚡ Cache metadata and artwork for faster startup, refresh the library, rebuild the index and exclude folders.
• 📋 Inspect unreadable files and retry guidance in Missing Tracks.
• 🧹 Optionally hide duplicate filenames without deleting music files.
• 📃 Create and save custom ClassiPod playlists.
• ⭐ Rate songs, with ratings and edits stored in ClassiPod.
• 📝 View embedded lyrics when available.
• 🎶 Play MP3, WAV, FLAC, M4A, MP4, Ogg, Opus, AAC, AIFF, APE, and MOV audio, subject to the platform's playback support.

• 🎡 Navigate with the rotating click wheel or touchscreen.
• ⏮️ Skip tracks, seek forward or backward, and adjust volume in the app.
• 🔀 Shuffle songs or whole albums, keeping album tracks in disc/track order.
• ➰ Repeat one song or the current queue.
• 💾 Restore the previous queue and selected song after reopening, paused at the beginning of the song.
• 💤 Set a sleep timer for 15, 30, 45, or 60 minutes, or the end of the song.
• 📱 Enjoy background playback and mobile media controls, Windows system media controls, and Linux MPRIS controls where supported.
• 📡 Recover server playback after temporary connection failures, with buffering feedback and a Retry action when needed.
• ⏩ Scrub to a previewed position before committing the seek.
• 💿 See queue position and progress in Now Playing, with access to ratings, shuffle controls, and available lyrics.

• 🎞️ Explore Cover Flow with Original and Big layouts, smooth wheel motion, and animated transitions.
• 🪞 Enjoy reflective album artwork.
• 🎨 Choose light and dark screen themes and device colors including Silver, Black, OLED Black, and more.
• 📺 Browse with split-screen previews and scrolling titles.
• 🔤 See a letter indicator while scrolling quickly through your collection.
• 📌 Return to remembered selections and scroll positions when navigating back.
• ⏱️ Automatically return to Now Playing after inactivity during playback; temporary Now Playing controls also return to the progress view.
• 🔉 Hear bundled iPod-inspired click wheel sounds.
• 📳 Enable vibration feedback on supported devices.
• 🖥️ Use responsive layouts and fullscreen Immersive Mode.
• 🔋 View battery level and charging status where supported.
• 📖 Get started with the introductory tutorial.
• ℹ️ Find app information in the About screen.
• 🌍 Use ClassiPod in your language with a multilingual interface.

ClassiPod imports a format when its metadata can be read and at least one configured playback backend can play it. Playback availability therefore varies by platform:

• 🎮 Ipod Built-in Games
• 📸 Ability to View Photos and Videos from the device

Open Settings → Library Settings → Subsonic and enter the server's base URL (including any reverse-proxy path), username and password. ClassiPod supports token-authenticated Subsonic API 1.13+ servers, including Navidrome. The connection is checked before saving. Native apps combine server and local music; Web shows the server library instead of demo songs while enabled.

Configure Subsonic edits the connection or removes it. Turning Subsonic off keeps its configuration and cache, hides its tracks, and stops server playback. Hide Local Music shows only server music while Subsonic is enabled. Prevent Duplicate Tracks hides matching filenames without deleting files. Saved playlist entries remain available when the same server is reconnected. Refresh Library fetches a new catalog; Re-index also clears cached server artwork. Failed scans retain the previous catalog. Ratings and edits stay in ClassiPod and are not written back to the server.

Native passwords use OS secure storage. Web passwords last only until reload; re-enter the password through Configure Subsonic or when starting playback. Metadata and artwork are cached, but audio is streamed and requires a connection. Server playlist synchronization and offline audio downloads are not included.

Web servers must allow CORS from the ClassiPod origin. Browsers block HTTP servers from an HTTPS app. Native apps allow HTTP for user-configured servers, including LAN IP addresses, using app-wide Android and Apple transport exceptions because server hosts are not known at build time. HTTPS certificates are still validated. HTTP traffic is unencrypted; prefer HTTPS when available. Transport configuration changes require rebuilding and reinstalling the app; hot reload does not apply them. Linux secure storage requires the system Secret Service/libsecret; Windows builds require the Visual Studio ATL component used by flutter_secure_storage.

Platform	Installation Links
Android
Linux
Windows
iOS	Unsigned; requires sideloading and signing on your device.
macOS	Apple Silicon and Intel; no Developer ID signature or notarization.
Web App

Download Classipod-iOS.ipa from a release that includes Apple builds. This is an unsigned device build, not an App Store or TestFlight download. Install it using AltStore Classic with AltServer, or another compatible sideloading tool, which signs it using your Apple account. Downloading the IPA in Safari alone does not install it.

With a free account, AltStore apps need refreshing every seven days, and the three-active-app limit includes AltStore itself. Follow the tool's installation instructions, including Developer Mode where required. See AltStore's account limits.

Download Classipod-macOS.dmg, open it, and drag classipod.app into Applications. The universal app supports Apple Silicon and Intel Macs running macOS 12 or later.

The app is not notarized or signed with an Apple Developer ID. It carries a local ad-hoc signature for execution on Apple Silicon; this does not verify a developer identity. Gatekeeper may block the first launch. If you trust the release, try opening the app, then use System Settings → Privacy & Security → Open Anyway and confirm. See Apple's instructions.

On both platforms, choose a parent music folder when prompted. ClassiPod scans its subfolders and caches metadata and artwork. Use Settings → Library Settings → Re-index to select a folder again and rebuild the index.

Apple downloads appear only on releases built with their platform options selected. See Apple release documentation for build commands, checksums, and release configuration. The web app can play demo songs or stream from a Subsonic/Navidrome server. It does not import local folders.

Aditya R

Copyright (c) 2025 Aditya R BSD-4-Clause LICENCE

Ipod icons created by Freepik - Flaticon