adeeteya/Classipod

🧭 Intuitive Navigation: Navigate through your music library effortlessly using the virtual click wheel. Scroll, click, and feel the tactile response as you rediscover the joy of selecting your favorite tracks with the same ease as the original iPod.

🗃️ Local Music Library: ClassiPod is focused on your locally stored music files, ensuring that your personal music collection takes center stage. Organize your tracks, albums, and playlists just like you did on your trusty iPod Classic.

🖌️ Customizable Themes: Personalize your ClassiPod experience with the option of silver or grey device frame. Choose from the two different color schemes to tailor the app's appearance to your unique style.

🖼️ Cover Art Display: Immerse yourself in your music by appreciating album artwork on the vibrant display. ClassiPod pays homage to the visual appeal of classic iPods by showcasing your favorite album covers in a retro-inspired format.

🎼 No Frills, Just Music: ClassiPod stays true to the essence of a music player – no distractions, no unnecessary features. Focus solely on the joy of listening to your favorite tunes without the complexities of a modern streaming service.

🎧 Offline Listening: Enjoy your music without relying on an internet connection. ClassiPod is perfect for those moments when you want to disconnect and savor the tunes stored locally on your device.

Relive the magic of the iPod Classic with ClassiPod – where timeless design meets the convenience of today. Download now and embark on a journey down memory lane with your music in the palm of your hand.

If you like what you see, please ⭐ the repo.

✨ Features

• 🗃️ Plays MP3, WAV, FLAC, M4A, MP4, Ogg, Opus, AAC, AIFF, APE, and MOV audio
• 🔎 Choose a Custom Folder To Scan Music From (By Default it is the Device Music Folder in the root folder of the device)
• 🎨 Multiple Ipod Classic Device Colors (Silver and Black)
• 🖼️ Displays the Music Metadata (Album Art, Artist Names)
• ⏩ Ability to seek forward and backwards on a audio file (By Long Pressing the seek forward/backwards buttons)
• ⏮️ Ability to go to previous and next track in the playlist
• 📱 Ipod Classic User Interface
• 🎞️ Cover Flow View
• 🎡 Click Wheel with Scrollable Rotation Enabled
• 💿 Now Playing Screen with current music progress displayed
• 🎶 Songs Screen with all the possible songs from the selected directory
• 🧑‍🎤 Ability to Filter and Select From a Particular Artist, Album or Genre
• 📲 Responsive Design For all Different Types of Screen Sizes
• 🔋 Displays the current device battery level and charging status on the status bar
• 🎧 Background Playback with Notification Control
• 🔀 Shuffle Songs Feature
• ➰ Loop Songs Feature (Loop one song or an entire playlist)
• 🔉 Click Wheel Sounds
• 📳 Vibration when clicking buttons and scrolling through the scroll wheel
• 🔇 In App Volume Control
• 🪞 Reflective Cover Art
• ℹ️ About Screen
• 🌍 Multi Language Support (Over 197 Languages Supported)
• 👆 Touch Screen Support
• 📺 Split Screen View (6th and 7th Gen iPod Classic)
• 🔍 Ability to search songs, artists, playlists and albums
• ⬇️ Caching Metadata of the songs for faster boot up times
• 📃 Ability to Create and Store Custom User Created Playlists
• 📖 App Usage Tutorial
• ⭐ Song Rating Feature
• 📝 Displays embedded lyrics in Now Playing

🎵 Supported audio formats

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:

Format	Extensions	Expected playback
MP3	.mp3	Android, iOS, Windows, Linux, web
PCM WAV	.wav	Android, iOS, Windows, Linux, web
FLAC	.flac	Android, iOS, Windows, Linux, major browsers
AAC in MP4	.m4a, .mp4	Android, iOS, Windows, Linux, major browsers
Ogg Vorbis	.ogg	Android, Windows, Linux, supporting browsers
Ogg Opus	.opus	Android, Windows, Linux, supporting browsers
Raw ADTS AAC	.aac	Android, iOS, Windows, Linux; browser-dependent
AIFF / AIFF-C	.aif, .aiff, .aifc	iOS, Windows, Linux
Monkey's Audio	.ape	Windows, Linux
QuickTime	.mov	iOS, Windows, Linux; browser-dependent

🔜 Upcoming Features

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

💻 Installation links

Platform	Installation Links
Android	Get it on Google Play Get it on F-Droid APK download
Linux	Download .AppImage Download .deb Download .rpm
Windows	Download Windows Installer
Web App	Web App

🔌 Plugins

Name	Usage
audio_metadata_reader	To read the metadata of the local mp3 files
audio_service	To support background audio playback
battery_plus	Shows phone battery level and status
cupertino_icons	For ios style icons
device_preview_plus	For visualizing how the app looks on different devices and screens
disable_battery_optimization	To Disable vendor or android specific battery optimizations for background playback
file_picker	To select the directory from which the music files are scanned
flutter_localizations	For in-app localization map data
flutter_riverpod	For State Management
go_router	To handle routing within the app
hive_ce	To Cache Auio Metadata and store playlists
hive_ce_flutter	For flutter specific libs of hive
intl	For internalization and localization of the app
just_audio	To play audio files
just_audio_background	To control audio through media notification
just_audio_media_kit	To play audio files on Windows and Linux
media_kit_libs_linux	Media kit Libraries for Linux
media_kit_libs_windows_audio	Media kit Libraries for Windows
on_audio_query	To fetch all the music files from Android and iOS
path_provider	To fetch app data directories
permission_handler	To check and request for file and audio access permissions
shared_preferences	To store system settings
tutorial_coach_mark	To provide app tutorial to the users
universal_html	For Launching the app in full-screen mode on web versions
url_launcher	For Launching the Donation Page Link
vibration	Used for vibration while using device controls
vibration_web	Used for vibration on the webapp version
build_runner	For code generation
custom_lint	For using custom lint rules
flutter_lints	For using recommended flutter lints
flutter_test	For unit and widget testing the app
hive_ce_generator	For automatically generating Hive TypeAdapters
riverpod_lint	For using riverpod specific linting rules

🤓 Author

Aditya R

🔖 LICENCE

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

🙏 Attributions

Ipod icons created by Freepik - Flaticon