/MuteWhenTalk

This script allows users to mute and unmute their system's audio output dynamically using a specified key. It leverages the 'pycaw' library for controlling the system's audio and the 'keyboard' library for capturing key presses and releases.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Dynamic Audio Mute Toggle

Introduction

Dynamic Audio Mute Toggle is a Python script that enables users to control their system's audio state (mute/unmute) using a designated keyboard key. This utility is particularly useful for individuals looking for a quick and easy way to toggle their audio output state without navigating through system settings or interfaces.

Features

  • Dynamic Key Binding: Users can choose any key to act as their mute/unmute toggle.
  • Instant Feedback: The script provides immediate auditory feedback by muting or unmuting the system's audio.
  • Simple Interface: Runs in the background, with minimal setup required.

Prerequisites

Before you begin, ensure you have met the following requirements:

  • Python 3.x installed on your system.
  • Administrative privileges may be required for listening to keyboard events.

Installation

To install Dynamic Audio Mute Toggle, follow these steps:

  1. Clone the repository:
    git clone https://github.com/awatchar/MuteWhenTalk.git
    
  2. Navigate to the project directory:
    cd MuteWhenTalk
    
  3. Install the required Python packages:
    pip install keyboard pycaw
    

Usage

To use Dynamic Audio Mute Toggle, run the following command in your terminal:

python MuteWhenTalk.py

Follow the on-screen instructions to set your preferred mute/unmute toggle key.

Contributing to MuteWhenTalk

To contribute to MuteWhenTalk, follow these steps:

  1. Fork this repository.
  2. Create a branch: git checkout -b branch_name.
  3. Make your changes and commit them: git commit -m 'commit_message'.
  4. Push to the original branch: git push origin MuteWhenTalk/branch_name.
  5. Create the pull request.

Alternatively, see the GitHub documentation on creating a pull request.

License

This project uses the following license: GNU GPL.