🎵 Portal

A minimal, material music player built around the music.

Clean playback · Cinematic artwork · Real-time equalizer · Material UI

📸 Screenshots

About

Portal is a focused music player designed to keep the interface quiet and the music prominent.

It combines artwork-first playback, fast discovery, playlists, background playback, queue controls, and a real-time equalizer in a clean Material-inspired interface.

Less interface. More music.

🎬 The Idea

Portal is a modern music player designed around one simple idea:

Make listening feel cinematic.

The interface stays quiet.

The artwork takes center stage.

Controls appear when you need them.

Music remains the focus.

Portal combines a minimal player experience with cinematic artwork, smooth animations, Liquid Glass navigation, YouTube-powered music discovery, background playback, playlists, and a real-time audio equalizer.

Version 2.0

Portal 2.0 is a production release focused on a cleaner, more refined listening experience.

Version 2.0 refines the audio experience, player flow, visual hierarchy, and overall interface.

The 2.0 release focuses on a complete playback experience, persistent settings, queue management, autoplay, sleep timer controls, and the cinematic player.

Four advanced playback/data features are still being actively implemented:

True crossfade
Audio normalization
High-quality stream selection
Wi-Fi-only network/download enforcement

Expect continued improvements while development continues.

Feedback and bug reports are welcome.

✨ What's New in v2.0

🎚️ Real-Time Equalizer

Portal now includes a real audio equalizer.

Presets

The equalizer is connected to the existing playback engine, so adjustments affect the music currently being played.

🎧 Music Playback

Portal provides a focused playback experience built around fast access to your music.

Playback

🎬 The Player

The player is designed to disappear into the experience.

Large artwork.

Minimal controls.

Smooth transitions.

Music first.

Cinematic Player

🏠 Home

Your music starts here.

The Home experience is built around recently played music, discovery, and artwork.

🔎 Search

Discover music without leaving the experience.

📚 Library

Your music, organized your way.

❤️ Liked Songs

🎵 Playlists

🕘 Recently Played

🕘 Playback history
🔄 Automatic updates
💾 Local persistence
▶️ Instant playback

🧊 Liquid Glass

Navigation isn't just navigation.

Portal uses a floating Liquid Glass interface to keep the app feeling alive without overwhelming the music.

🔔 Background Playback

Portal is designed to keep music available while you move through the app.

⚙️ Settings

Settings are designed to stay simple while giving you control over the listening experience.

In Development

🔀 True overlapping crossfade
🔊 Actual audio normalization
🎧 Actual high-quality stream selection
📶 Actual Wi-Fi-only enforcement

💾 Local Data

Portal keeps important user preferences available between launches.

🎨 Design

Portal 2.0 uses a restrained Material-inspired visual system:

Minimal surfaces and clear hierarchy
Artwork-led playback
Consistent spacing and typography
Subtle motion instead of visual noise
Light and dark themes
Focused controls with familiar Material patterns

Less interface. More music.

🐛 Known Issues

Portal continues to evolve with ongoing refinements and improvements.

Current areas being improved:

🔀 True crossfade — overlapping two tracks is still being implemented
🔊 Audio normalization — actual loudness normalization is still being implemented
🎧 High-quality streaming — quality selection is still being wired into the stream pipeline
📶 Wi-Fi only — network/download enforcement is still being wired into the data layer
⚡ Startup performance — continued optimization
🎵 Playback stability — edge cases continue to be refined
🐞 General bugs — ongoing fixes

Portal 2.0 is a production release. Advanced playback features continue to evolve.

🚧 Coming Soon

🔮 Future Ideas

Ideas being explored for future versions:

Future ideas are exploratory and are not guaranteed features.

🗺️ Roadmap

Feature	Status
Music playback	🟢 Working
Play / Pause	✅ Done
Previous track	✅ Done
Next track	✅ Done
Queue	✅ Done
Queue playback	🟢 Working
Automatic next track	✅ Autoplay implemented
Startup performance	🟡 Improving
Mini player	✅ Done
Full-screen player	✅ Done
Cinematic player	✅ Done
Recently played	✅ Done
Liked songs	✅ Done
Playlists	✅ Done
Search	✅ Done
Search history	✅ Done
Library	✅ Done
Sleep timer	✅ Done
Real-time Equalizer	✅ Done
Equalizer presets	✅ Done
Settings persistence	✅ Done
About screen	✅ Done
Liquid Glass navigation	✅ Done
Light theme	✅ Done
Dark theme	✅ Done
Background playback	🟢 Working
True crossfade	🚧 In development
Audio normalization	🚧 In development
High-quality stream selection	🚧 In development
Wi-Fi-only enforcement	🚧 In development
Offline playback	🚧 Coming soon
Listening statistics	🚧 Coming soon
Google Play Store	🚧 Coming soon

🛠️ Built With

Portal is built with:

Flutter
Dart
Material Design
just_audio
audio_service
youtube_explode_dart
shared_preferences
flutter_screenutil_plus
liquid_glass_easy
flutter_animate
flutter_hicons
flutter_svg

📱 Platform

Current

Android

Coming Soon

Google Play Store

🖼️ README Assets

Add the following files to the repository so the README renders correctly:

assets/
└── poster.png

screenshots/
├── 01-home.png
├── 02-search.png
├── 03-player.png
├── 04-library.png
├── 05-playlists.png
├── 06-equalizer.png
└── 07-settings.png

🚀 Getting Started

Prerequisites

Make sure you have:

Flutter SDK
Dart SDK
Android Studio
Android SDK
A connected Android device or emulator

Clone

git clone https://github.com/souravkaushik-dev/Portal.git
cd Portal

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
android		android
ios		ios
lib		lib
linux		linux
macos		macos
packages/youtube_explode_dart		packages/youtube_explode_dart
test		test
web		web
windows		windows
.gitignore		.gitignore
.metadata		.metadata
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Latest commit

History

Folders and files

Repository files navigation

🎵 Portal

📸 Screenshots

About

🎬 The Idea

Version 2.0

✨ What's New in v2.0

🎚️ Real-Time Equalizer

Presets

🎧 Music Playback

Playback

🎬 The Player

Cinematic Player

🏠 Home

🔎 Search

📚 Library

❤️ Liked Songs

🎵 Playlists

🕘 Recently Played

🧊 Liquid Glass

🔔 Background Playback

⚙️ Settings

In Development

💾 Local Data

🎨 Design

🐛 Known Issues

🚧 Coming Soon

🔮 Future Ideas

🗺️ Roadmap

🛠️ Built With

📱 Platform

Current

Coming Soon

🖼️ README Assets

🚀 Getting Started

Prerequisites

Clone

About

Topics

Resources

Stars

Watchers

Forks

Releases

Contributors

Languages