Kiokuu
Kiokuu
Your Personal Cloud Music Streaming Platform
Features • Screenshots • Installation • Tech Stack • Contributing
Features
Music Streaming
- Cloud Library — Upload your music collection and stream from anywhere
- High-Quality Playback — Powered by MediaKit/MPV for lossless audio support
- Offline Mode — Download songs for offline listening with automatic HD upgrades
- Background Playback — Full audio service integration with notification controls
AI-Powered
- Smart Matching — AI identifies your uploaded songs and fetches metadata automatically
- Lyrics Sync — Synchronized lyrics display with beautiful full-screen visualizations
Cross-Platform
- Native Experience — Runs on Android, iOS, Linux, Windows, macOS, and Web
- Seamless Sync — Playback state syncs across all your devices in real-time
- Responsive Design — Adapts beautifully from mobile to desktop
Social
- Friend Activity — See what your friends are listening to
- Shared Playlists — Collaborate on playlists with friends
- Listen Together — Sync playback with friends in real-time
Premium Features
- Unlimited Uploads — No storage limits for premium users
- Priority Streaming — Dedicated CDN for faster streams
- Early Access — Get new features before everyone else
Design Philosophy
Kiokuu features a stunning monochromatic design with:
- Elegant dark theme with glassmorphic elements
- Smooth micro-animations and transitions
- Dynamic backgrounds that adapt to album artwork
- Fluid, gesture-driven navigation
Installation
Prerequisites
- Flutter SDK 3.38.5 or higher
- Dart SDK 3.10.1 or higher
Setup
# Clone the repository
git clone https://github.com/Xumi-cc/Kiokuu.git
cd Kiokuu
# Install dependencies
flutter pub get
# Run the app
flutter run -d <device>
Available devices:
| Device | Command |
|---|---|
| Android | flutter run -d android |
| iOS | flutter run -d ios |
| Linux | flutter run -d linux |
| Windows | flutter run -d windows |
| macOS | flutter run -d macos |
| Web | flutter run -d chrome |
Tech Stack
| Component | Technology |
|---|---|
| Framework | Flutter 3.38+ |
| Language | Dart 3.10+ |
| State Management | Provider |
| Audio Engine | MediaKit (MPV) |
| Background Audio | audio_service + MPRIS |
| Networking | HTTP + WebSocket |
| Local Storage | flutter_secure_storage |
| Authentication | Google Sign-In, Discord OAuth |
Project Structure
kiokuu/
├── lib/
│ ├── screens/ # UI screens
│ ├── providers/ # State management
│ ├── services/ # API & audio services
│ ├── models/ # Data models
│ └── widgets/ # Reusable components
│
├── assets/ # Static assets
├── android/ # Android-specific code
├── ios/ # iOS-specific code
├── linux/ # Linux-specific code
├── windows/ # Windows-specific code
├── macos/ # macOS-specific code
└── web/ # Web-specific code
Building for Release
Android
flutter build apk --release --split-per-abi
# or for Play Store
flutter build appbundle --release
iOS
flutter build ios --release
Linux
flutter build linux --release
Windows
flutter build windows --release
macOS
flutter build macos --release
Web
flutter build web --release
Authentication
Kiokuu supports multiple authentication methods:
- Email/Password — Traditional authentication
- Google Sign-In — OAuth 2.0 integration
- Discord — OAuth 2.0 with deep linking support
License
This project is licensed under the MIT License.
Contributing
Contributions are welcome! Please read our contributing guidelines before submitting a pull request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Contact
- Website: kiokuu.app
- Email: support@kiokuu.app
- Discord: Join our community
Made with care by Xumi Labs