RingtoneSmartKit

RingtoneSmartKit - Lightweight Kotlin Library for Android

RingtoneSmartKit offers a seamless solution for Android developers looking to set and customize ringtones, notification sounds, and alarms with minimal effort. This lightweight Kotlin library allows users to manage ringtones programmatically, either globally or for specific contacts, without the need for cumbersome boilerplate code.

Key Features

• Simplified API: Easily set system and contact ringtones without managing Context or Activity references.
• Multiple Sources: Supports ringtones from assets, local storage (URI), and remote URLs, providing flexibility in how sounds are sourced.
• Contact-Specific Ringtones: Assign different ringtones to specific contacts using various identifiers, including phone numbers and contact URIs.
• Asynchronous Operations: Utilize success and error callbacks for efficient handling of ringtone operations, enhancing control over execution.
• Diverse Ringtone Types: Capability to set various system ringtones—call, notification, and alarm—ensuring comprehensive functionality.
• Kotlin-First Design: Entirely written in Kotlin, RingtoneSmartKit embraces idiomatic usage and is designed to be extension-friendly.

Usage Examples

Set a System Ringtone

RingtoneHelper.setSystemRingtone(
  source = RingtoneSource.FromAssets("ringtones/my_ringtone.mp3"),
  target = SystemTarget.Call // or Notification, Alarm
).onSuccess {
  println("✅ System ringtone set successfully")
}.onFailure { error ->
  println("❌ Error setting system ringtone: ${error.message}")
}.onDone {
  println("Operation completed")
}.launch()

Set a Ringtone for a Specific Contact

RingtoneHelper.setContactRingtone(
  source = RingtoneSource.FromStorage(Uri.parse("content://media/internal/audio/media/10")),
  target = ContactTarget.ByPhone("+1234567890")
).onSuccess { contact ->
  println("✅ Ringtone set for contact: ${contact.displayName}")
}.onFailure { error ->
  println("❌ Error setting contact ringtone: ${error.message}")
}.onDone {
  println("Operation completed")
}.launch()

Ringtone Source Options

Ringtones can be loaded from:

// From the app's assets directory:
RingtoneSource.FromAssets(filePath = "ringtones/my_ringtone.mp3")

// From device storage:
RingtoneSource.FromStorage(uri = "content://media/internal/audio/media/10".toUri())

Callbacks

Availability

RingtoneSmartKit is available for easy integration via:

• Maven Central: Maven Central
• GitHub Packages: GitHub Packages

For more information, source code, and documentation, visit the GitHub Repository.

RingtoneSmartKit provides a straightforward, efficient way to enhance Android applications by managing ringtones with minimal complexity.