Sausico

A Modern, High-Performance JioSaavn Client

Experience music streaming reimagined with cutting-edge technology and thoughtful design.

🌐 Website: https://sausico.pages.dev

---

📌 Table of Contents

• ⬇ Download
• ✨ Features
• 🖼 Screenshots
• ⚡ Quick Start
• 🛠 Troubleshooting
• ⚖ Legal Notice

---

⬇ Download

Current Version: v1.0.1

Choose the build that matches your device architecture.

Build Variant	Device Compatibility	Download
arm64-v8a	Modern Android devices (2015+)
armeabi-v7a	Older Android devices (pre-2015)
x86_64	Emulators and x86-based devices
x86	Legacy emulators

Quick Guide: Download arm64-v8a first. If it installs successfully, you've got the right one. If installation fails, try armeabi-v7a instead.

---

Why Sausico?

• 🏗️ Production-Ready Architecture – Built for scale and maintainability
• ⚡ Blazing Fast – Optimized with MMKV storage and efficient state management
• 🎨 Beautiful UI/UX – Dynamic theming and smooth animations
• 🔊 Professional Playback – Background audio, queue management, and rich controls
• 🧪 Modern Stack – React 19, Expo SDK 54, React Native 0.81

---

✨ Features

🎧 Audio Experience Background audio playback with foreground service Seamless queue management (play next, add to queue) Full media controls (seek, skip, repeat, shuffle) Android lock-screen & notification controls Gapless playback support Audio focus handling	🔍 Discovery & Search Powerful search across songs, albums, artists, playlists Voice search with on-device speech recognition Curated home feed with personalized content Trending charts and new releases Genre-based browsing Smart recommendations
📚 Library Management Favorites and collections Listening history tracking Offline downloads support Custom playlist creation Recently played quick access Library sync and backup	🎨 UI & Design Dynamic color theming from album artwork Mini-player with gesture controls Immersive full-screen player Smooth transitions and animations Tablet-optimized layouts Dark mode support Global snackbar feedback system

---

📱 Screenshots

Core Experience

Home Feed Trending content and suggestions

Full Player Immersive playback experience

Downloads Offline content management

Search & Discovery

Search Interface Full text search over categories

Search Results Categorized results with quick filters

Voice Search On-Device Voice Search

Media Details

Album View Complete album information

Artist Profile Top tracks & discography

Playlist View Curated & custom playlists

Library & Collections

Favorites Liked songs & albums

Collections Organized library sections

Custom Collection User-defined music collections

Bonus Features

Track Menu Context menu with rich actions

Audio Quality High fidelity playback options

History List of recently played tracks

---

🚀 Quick Start

Prerequisites

Before you begin, ensure you have the following installed:

Requirement	Version	Download
Node.js	18.x or higher	nodejs.org
Java JDK	17 (recommended)	Oracle JDK
Android SDK	Latest	Via Android Studio
Android Device/Emulator	API 21+	Android Studio

⚠️ Important Notice

This project uses native modules and cannot run in Expo Go. You must build and run a development client.

Installation

1. Clone the repository

git clone https://github.com/saavn-labs/app.git
cd app

2. Install dependencies

# Using npm
npm install

# Using yarn
yarn install

# Using bun
bun install

3. Build and run development client

# Build and install on connected Android device/emulator
npm run android

# Start the Metro bundler
npx expo start --dev-client

4. Launch the app

Open the installed development client on your device and it will automatically connect to Metro.

---

🐛 Troubleshooting

Common Issues

App crashes on launch

Solution:

# Rebuild the development client
npm run android

# Clear Metro cache
npx expo start -c

No audio playback

Possible causes:

• Development client not properly installed
• Android audio focus not granted
• Service not registered in AndroidManifest.xml

Solution:

# Reinstall with clean build
cd android && ./gradlew clean
cd .. && npm run android

Build errors with Gradle

Solution:

# Clean Gradle cache
cd android
./gradlew clean
rm -rf .gradle
cd ..

# Rebuild
npm run android

Metro bundler issues

Solution:

# Clear all caches
npx expo start -c
watchman watch-del-all  # If using watchman
rm -rf node_modules && npm install

---

📄 Legal Notice

This is an unofficial application.

• Not affiliated with, endorsed by, or connected to JioSaavn
• Does not host, store, or redistribute any copyrighted content
• All media data and URLs are fetched from publicly accessible APIs
• Usage compliance is the sole responsibility of the end user

This project is intended for educational and personal use only. Please respect copyright laws and support artists by using official platforms.

---

License

MIT © 2026 Saavn Labs

See LICENSE for details.

---

Built by Saavn Labs with a focus on correctness and longevity.