Amadz is a modern Android calling application built with Jetpack Compose, Navigation 3, Hilt, and Paging 3. It is designed as an alternative to the default Phone app, with a modular architecture and full call handling. The latest release is 1.1.7 and supports Android 8.0 (API 26) and newer.
Or download the latest APK from the Releases Section.
- Full incoming, outgoing, and ongoing call handling
- Foreground service–based call management
- Full-screen incoming call notifications
- Missed call notifications
- Chronometer support for active calls
- Proximity sensor support during calls
- Multi-SIM support with SIM labels in call history
- DTMF tone playback on dial pad
- Mute and speaker controls in ongoing-call notifications
- Speaker control while a call is ringing
- Complete call history screen
- Grouping by date with sticky headers
- Pagination using Paging 3
- Consecutive calls to the same number grouped with a call count
- Rejected call type support
- Add unsaved numbers directly to contacts
- Delete call log entries
- Clear all call history from Settings
- Automatic refresh when the device call log changes
- SIM display names and formatted phone numbers
- Block / Unblock directly from history
- Compatible call-log queries for devices such as GrapheneOS
-
Sync favourites with Android starred contacts
-
Add / Remove favourites
-
Grid-based favourites layout
-
Contact detail navigation
-
T9 contact search from the dial pad
-
Add a dialed number to a new or existing contact
-
Search by:
- Name
- Phone number
- Address
-
Proper handling of contacts with multiple numbers
-
Improved contact name and photo lookup
- Block and unblock numbers
- Automatic rejection of blocked incoming calls
- Exact-number and regular-expression blocking rules
- International number normalization for matching
- Persistent storage using DataStore
- Integrated search + dial pad experience
- State-driven search bar (Collapsed / Expanded / Dial Pad mode)
- Frequently called contacts suggestion
- Dial-pad copy, paste, and cursor-aware editing
- BackHandler-aware navigation behavior
- Animated FAB and bottom bar transitions
-
Separate notification channels:
- High priority for incoming calls
- Low priority for ongoing calls
-
Silent ongoing notifications (no vibration)
-
Dynamic notification channel handling
-
BroadcastReceiver-based call actions
-
Clean ringtone management via dedicated controller
- Enable or disable dial-pad tones while respecting system sound settings
- Open Android sound and vibration settings
- Manage blocked numbers
- Clear call history
Amadz now uses a modern Android stack:
-
Jetpack Compose (BOM 2026.09.00)
-
Navigation 3
-
Hilt dependency injection
-
Paging 3.5.1
-
Kotlin 2.4.20
-
KSP (Kotlin Symbol Processing)
-
DataStore Preferences
-
Foreground service–based call orchestration
-
Domain-driven call state management
-
Modular separation of:
- UI
- Domain
- Data
- Call orchestration
- Audio handling
- Notification handling
- Replaced legacy call adapter with
CallOrchestrator - Introduced session-aware coroutine scope management
- Decoupled ringtone, audio, and notification logic
- Extracted UI effects into dedicated handlers
- Migrated to Version Catalog (TOML)
- Improved lifecycle cleanup to prevent leaks
- Modernized navigation stack (Nav3)
- Standardized phone-number normalization and display formatting for international numbers
- Added cached contact lookups and improved contact photo resolution
- Migrated call-blocking and dial-pad tone preferences to DataStore, including legacy preference migration
- Updated call-log pagination to use provider-compatible content URI parameters
To enable full functionality:
-
Set Amadz as your default Phone app Settings → Apps → Default Apps → Phone App → Amadz
-
Grant required permissions:
- Phone and call-log access
- Contacts
- Notifications
- Foreground phone-call service
Contributions are welcome.
You can help by:
- Reporting bugs
- Improving UI/UX
- Enhancing call features
- Optimizing architecture
- Improving documentation
git checkout -b feature/your-feature
git commit -m "Add your feature"
git push origin feature/your-featureThen open a Pull Request.
Apache License 2.0 © 2023–2026 msusman1
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.