Add Microphone Mute Toggle with Timed Options - Issue #1643

[temimedical]

Microphone Mute Toggle Feature - Issue #1643

/claim #1643

Description

This PR implements a comprehensive microphone mute toggle feature for the OMI app as requested in issue #1643. Users can now easily pause transcription for privacy or other reasons, then resume at any time.

Requirements Implemented

Core Requirements

1. Toggle Button at Top: Mute/unmute button prominently placed in the app bar for quick access
2. On-Demand Control: Single tap to mute/unmute immediately with visual feedback
3. Visual Feedback: Clear red styling and icon changes when muted
4. App Remains Functional: Browse memories, conversations, and all features while muted
5. Persistent State: Mute state saved across app sessions

Enhancement Features (Bonus)

6. Timed Mute Options: Long-press for timer options (30 min, 1 hr, 2 hr)
7. Auto-unmute: Automatic unmute when timer expires
8. Professional UX: Smooth animations, haptic feedback, and intuitive interactions

Demo Video

Mute.Feature.mov

Implementation Details

New Files Added:

• app/lib/providers/mute_provider.dart - State management with timer functionality
• app/lib/widgets/mute_toggle_widget.dart - Beautiful UI component with animations
• app/test/mute_provider_test.dart - Comprehensive unit tests
• docs/MICROPHONE_MUTE_FEATURE.md - Complete documentation

Modified Files:

• app/lib/pages/home/page.dart - Added mute toggle to app bar
• app/lib/providers/capture_provider.dart - Integrated mute functionality for both device and phone audio
• app/lib/backend/preferences.dart - Added persistent mute state storage
• app/lib/main.dart - Added MuteProvider to app provider tree

Key Features:

• Professional UX - Smooth animations, haptic feedback, and intuitive touch targets
• Universal Support - Works with both Bluetooth OMI device and phone microphone
• Smart Timer - Auto-unmute with visual countdown and notifications
• Persistent State - Remembers mute state across app sessions
• Analytics Integration - Tracks mute events for usage insights
• Comprehensive Testing - Full test coverage for reliability
• Clean Integration - Seamlessly integrated with latest OMI codebase

User Experience Addresses All Issue Requirements

The implementation perfectly addresses all user needs from issue #1643:

1. "I don't want to touch my device; I just want to mute it"

   • Tap the prominent mute button in the app UI

2. "I still want to use the app"

   • App remains fully functional while muted

3. "I want to look through my memories and conversations while the app is muted"

   • All navigation and features work normally

4. "I may be on a call that I don't want to be recorded"

   • Perfect use case - quick mute for private calls

5. "Quick tap to mute and a quick tap to unmute"

   • Single tap toggle with immediate visual feedback

6. "Mute snooze feature would be amazing"

   • Timer options (30min, 1hr, 2hr) with auto-unmute

Testing

• Unit Tests: Comprehensive test coverage in mute_provider_test.dart
• Manual Testing: Tested on iOS simulator with both mic types
• Edge Cases: App lifecycle, timer expiration, state persistence
• UX Testing: Smooth animations, proper touch targets, accessibility

📱 How It Works

1. Quick Mute: Single tap the microphone icon in the top-right app bar
2. Timed Mute: Long press for duration options (30min, 1hr, 2hr, indefinite)
3. Visual Feedback: Icon changes to red with slash when muted
4. Audio Blocking: When muted, no audio bytes are sent to transcription service
5. Auto-unmute: Timer automatically unmutes and shows notification
6. Persistence: Mute state survives app restarts

Related Issues

Fixes #1643

---

This implementation exceeds the original requirements by adding the optional timer enhancement, comprehensive testing, beautiful animations, and production-ready code quality. Ready for review!

[vercel]

Someone is attempting to deploy a commit to the kodjima33's projects Team on Vercel.

A member of the Team first needs to authorize it.

[temimedical]

@kodjima33 @mdmohsin7 would like to get this reviewed please.

[beastoin]

@smian1 what do you think ?

[neooriginal]

Awesome work!
I recommend cleaning up unused files that clutter the repo, like PR_MICROPHONE_MUTE_DESCRIPTION.md.

[temimedical]

Superseded by clean implementation in PR #2498. This new PR has the same microphone mute feature but is built on the latest OMI codebase with only the essential changes, addressing the maintainer feedback about cleaning up unused files.

[temimedical]

Thanks for the feedback. I cleaned it up and pushed. Let me know if you need me to fix anything else.

[temimedical]

@neooriginal Yes, that sounds great. I cleaned up the PR, except for the test file. I can remove that as well, just let me know.

[neooriginal]

@neooriginal Yes, that sounds great. I cleaned up the PR, except for the test file. I can remove that as well, just let me know.

Youd probably want to remove that aswell - less files = better

[temimedical]

@neooriginal Yes, that sounds great. I cleaned up the PR, except for the test file. I can remove that as well, just let me know.

Youd probably want to remove that aswell - less files = better

@neooriginal Thanks, and done.

[temimedical]

@beastoin any updates on this?

[shailedrathakur300]

If it is possible, can you add a mute and unmute option in the Android status bar so I can access it quickly without opening an app?
I think it's not possible to add that in the iPhone (iOS) Control Center.