Skip to content

Vanhoai/AICMusic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

53 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎡 ICMusic

Android Kotlin Compose License

ICMusic is a modern Android application that allows users to download and listen to music from YouTube, featuring a beautiful user interface and smooth user experience.

thumbnail

✨ Key Features

  • 🎬 Direct music downloads from YouTube
  • 🎡 Feature-rich music player
  • πŸ“± Modern UI with Jetpack Compose
  • πŸ“₯ Easy download management
  • 🎨 Material Design 3 with dark mode support
  • πŸ“‹ Create and manage playlists
  • πŸ”„ Local data synchronization

πŸ› οΈ Technology Stack

  • Kotlin - Primary programming language
  • Jetpack Compose - Modern UI toolkit
  • Material Design 3 - Design system
  • Kotlin Coroutines & Flow - Asynchronous programming
  • Hilt - Dependency injection
  • Room Database - Local storage
  • ExoPlayer - Music playback
  • Retrofit - Networking
  • Coil - Image loading and caching
  • YouTube Data API - Video search and download
  • Clean Architecture with MVVM pattern

πŸ“± Screenshots

Home Screen Player Screen Library Screen

βš™οΈ System Requirements

  • Android 6.0 (API level 23) or higher
  • 50MB of free storage
  • Internet connection

πŸš€ Installation

  1. Clone the repository:
git clone https://github.com/yourusername/ICMusic.git
  1. Open the project in Android Studio

  2. Add your YouTube API key to local.properties:

YOUTUBE_API_KEY=your_api_key_here
  1. Build and run the application

πŸ“– Usage Guide

Downloading Music

  1. Open the app and tap the search icon
  2. Enter a song name or paste a YouTube URL
  3. Select the desired song
  4. Tap the download button and wait for completion

Playing Music

  • Tap any song to play
  • Use control buttons for play/pause, next, previous
  • Swipe up on the mini player to open full-screen player
  • Create playlists by long-pressing a song and selecting "Add to playlist"

🀝 Contributing

We welcome all contributions! If you'd like to contribute:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

ICMusic is distributed under the MIT License. See LICENSE for more information.

πŸ“ž Contact

πŸ™ Acknowledgments

Thanks to the open-source libraries used in this project:

πŸ”’ Privacy & Security

ICMusic takes your privacy seriously. We:

  • Only request necessary permissions
  • Don't collect personal data
  • Store all data locally on your device
  • Use secure HTTPS connections
  • Never share your information with third parties

πŸ› Bug Reporting

Found a bug? Please help us improve by reporting it:

  1. Go to the Issues tab
  2. Click "New Issue"
  3. Select "Bug Report"
  4. Fill in the template with as much detail as possible

πŸš€ Upcoming Features

  • Offline mode
  • Crossfade between tracks
  • Advanced equalizer
  • Cloud backup
  • Lyrics integration
  • Social sharing features

About

🎡 Modern Android music player and YouTube downloader built with Jetpack Compose and Material You design. Supporting offline playback, playlist management and background downloads. Clean Architecture with latest Android development practices.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages