muteaimp 0.1.0__tar.gz

muteaimp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Groot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

muteaimp-0.1.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: muteaimp
+Version: 0.1.0
+Summary: Script to stop AIMP when other video or audio is playing
+Author: Groot
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: pyaimp>=0.2,<1
+Requires-Dist: pycaw>=20260921
+Requires-Python: >=3.9
+Project-URL: Homepage, https://github.com/grootle/muteAIMP
+Project-URL: Repository, https://github.com/grootle/muteAIMP
+Project-URL: Issues, https://github.com/grootle/muteAIMP/issues
+Description-Content-Type: text/markdown
+
+# AIMP Auto Pause/Resume
+
+AIMP Auto Pause/Resume is a Python utility that automatically controls the playback of the AIMP music player based on the state of other audio sessions on your system. When any other application (e.g., a video player) is actively running the utility will pause AIMP. Once these sessions become inactive, AIMP will resume playing.
+
+## Features
+
+- **Automatic Detection:** Monitors system audio sessions using the [pycaw](https://github.com/AndreMiras/pycaw) library.
+- **Seamless AIMP Control:** Automatically pauses AIMP when another application is active and resumes playback when all other sessions are inactive.
+
+## Prerequisites
+
+- **Python:** 3.6+
+- **Required Python Packages:**
+  - [pyaimp](https://pypi.org/project/pyaimp/)
+  - [pycaw](https://github.com/AndreMiras/pycaw)
+
+## Installation
+
+1. **Clone the Repository:**
+
+   ```bash
+   git clone https://github.com/grootle/muteAIMP.git
+   cd muteAIMP
+   ```
+
+2. **Create a Virtual Environment (Optional):**
+
+   ```bash
+   python -m venv venv
+   source venv/Scripts/activate  # On Windows: venv\Scripts\activate
+   ```
+
+3. **Install Dependencies:**
+
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+   If you do not have a `requirements.txt`, you can install the packages individually:
+
+   ```bash
+   pip install pyaimp pycaw
+   ```
+
+## Usage
+
+1. **Ensure AIMP is Installed:**  
+   Make sure AIMP is installed on your system and that the executable name is `AIMP.exe`.
+
+2. **Run the Script:**
+
+   ```bash
+   python main.py
+   ```
+
+   The script will register for audio session notifications on your system. It will monitor the audio sessions and automatically pause AIMP if any other session becomes active, resuming playback when they become inactive.
+
+3. **Logging:**  
+   The console output will display debugging messages, such as active session changes and AIMP control actions (pause/resume).
+
+## Customization
+
+- **AIMP Executable Name:**  
+  If your AIMP executable has a different name, update the `AIMP_EXE` constant in `main.py`.
+
+- **Polling Interval:**  
+  The script uses an infinite loop with a 1-second delay to keep running. Adjust `time.sleep(1)` in the main loop if you need a different interval.

muteaimp-0.1.0/README.md

@@ -0,0 +1,67 @@
+# AIMP Auto Pause/Resume
+
+AIMP Auto Pause/Resume is a Python utility that automatically controls the playback of the AIMP music player based on the state of other audio sessions on your system. When any other application (e.g., a video player) is actively running the utility will pause AIMP. Once these sessions become inactive, AIMP will resume playing.
+
+## Features
+
+- **Automatic Detection:** Monitors system audio sessions using the [pycaw](https://github.com/AndreMiras/pycaw) library.
+- **Seamless AIMP Control:** Automatically pauses AIMP when another application is active and resumes playback when all other sessions are inactive.
+
+## Prerequisites
+
+- **Python:** 3.6+
+- **Required Python Packages:**
+  - [pyaimp](https://pypi.org/project/pyaimp/)
+  - [pycaw](https://github.com/AndreMiras/pycaw)
+
+## Installation
+
+1. **Clone the Repository:**
+
+   ```bash
+   git clone https://github.com/grootle/muteAIMP.git
+   cd muteAIMP
+   ```
+
+2. **Create a Virtual Environment (Optional):**
+
+   ```bash
+   python -m venv venv
+   source venv/Scripts/activate  # On Windows: venv\Scripts\activate
+   ```
+
+3. **Install Dependencies:**
+
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+   If you do not have a `requirements.txt`, you can install the packages individually:
+
+   ```bash
+   pip install pyaimp pycaw
+   ```
+
+## Usage
+
+1. **Ensure AIMP is Installed:**  
+   Make sure AIMP is installed on your system and that the executable name is `AIMP.exe`.
+
+2. **Run the Script:**
+
+   ```bash
+   python main.py
+   ```
+
+   The script will register for audio session notifications on your system. It will monitor the audio sessions and automatically pause AIMP if any other session becomes active, resuming playback when they become inactive.
+
+3. **Logging:**  
+   The console output will display debugging messages, such as active session changes and AIMP control actions (pause/resume).
+
+## Customization
+
+- **AIMP Executable Name:**  
+  If your AIMP executable has a different name, update the `AIMP_EXE` constant in `main.py`.
+
+- **Polling Interval:**  
+  The script uses an infinite loop with a 1-second delay to keep running. Adjust `time.sleep(1)` in the main loop if you need a different interval.

muteaimp-0.1.0/muteaimp/main.py

@@ -0,0 +1,97 @@
+import time
+from pyaimp import Client, PlayBackState
+from pycaw.pycaw import AudioUtilities, IAudioMeterInformation
+
+# Constant for the AIMP executable name
+AIMP_EXE = 'AIMP.exe'
+# Variable to keep track of the last command sent to avoid redundant actions
+sent_command = 'play'
+
+last_message = ''
+PAUSE_MESSAGE = "AIMP paused due to active session."
+RESUME_MESSAGE = "AIMP resumed as no active session found."
+
+
+def display_message(message):
+    global last_message
+
+    if last_message != message:
+        print(message)
+        last_message = message
+
+
+def is_peak_value_exist(session) -> bool:
+    """Check if the audio session is producing any significant sound"""
+
+    # Query the IAudioMeterInformation interface for peak audio value
+    volume = session._ctl.QueryInterface(IAudioMeterInformation)
+    peak = volume.GetPeakValue()
+
+    # If the peak value is greater than the threshold, consider it as active
+    return peak > 0.00001
+
+
+def get_audio_sessions() -> list:
+    """
+    Get a list of process names that are actively producing audio.
+    
+    Returns:
+        List of process names with active audio output.
+    """
+    sessions = AudioUtilities.GetAllSessions()
+
+    # Filter sessions to include only those with an associated process
+    active_sessions = [
+        session.Process.name() for session in sessions if session.Process and is_peak_value_exist(session) and session.Process.name() != AIMP_EXE
+    ]
+
+    if active_sessions:
+        message = f"Active sessions: {' - '.join(active_sessions)}"
+        display_message(message)
+
+    return active_sessions
+
+
+def control_aimp():
+    """
+    Control AIMP playback based on other active audio sessions.
+    
+    If AIMP is playing and other processes are producing audio, pause AIMP.
+    If AIMP is paused (by this script) and no other audio is active, resume playback.
+    """
+    global sent_command  # Declare the global variable so we can modify it
+
+    active_sessions = get_audio_sessions()
+
+    try:
+        # Create a client instance for AIMP control
+        client = Client()
+        state = client.get_playback_state()
+
+        # If AIMP is playing and there are other active audio sessions, pause playback.
+        if state == PlayBackState.Playing and active_sessions:
+            client.pause()
+            sent_command = 'pause'
+            display_message(PAUSE_MESSAGE)
+        # If AIMP is not playing and it was paused by this script, resume playback when no other audio is active.
+        elif state != PlayBackState.Playing and sent_command == 'pause' and not active_sessions:
+            client.play()
+            sent_command = 'play'
+            display_message(RESUME_MESSAGE)
+    except RuntimeError:
+        # In case of errors with AIMP client operations, do nothing.
+        pass
+
+
+def main():
+    """Main loop that continuously checks active audio sessions and controls AIMP playback"""
+    while True:
+        control_aimp()
+        # Delay between checks; lower this value for faster response at the expense of higher CPU usage.
+        time.sleep(1)
+
+
+if __name__ == "__main__":
+    main()
+    # This sleep is redundant because main() has an infinite loop, but kept for safety.
+    time.sleep(100)

muteaimp-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[project]
+name = "muteaimp"
+version = "0.1.0"
+description = "Script to stop AIMP when other video or audio is playing"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+dependencies = [
+    "pyaimp>=0.2,<1",
+    "pycaw>=20260921",
+]
+
+[[project.authors]]
+name = "Groot"
+
+[project.urls]
+Homepage = "https://github.com/grootle/muteAIMP"
+Repository = "https://github.com/grootle/muteAIMP"
+Issues = "https://github.com/grootle/muteAIMP/issues"
+
+[project.scripts]
+muteaimp = "muteaimp.main:main"
+
+[build-system]
+requires = ["uv_build>=0.12.9,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = ""

muteaimp-0.1.0/pyproject.toml.orig

@@ -0,0 +1,30 @@
+[project]
+name = "muteaimp"
+version = "0.1.0"
+description = "Script to stop AIMP when other video or audio is playing"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Groot" }
+]
+requires-python = ">=3.9"
+dependencies = [
+    "pyaimp>=0.2,<1",
+    "pycaw>=20260921",
+]
+
+[project.urls]
+Homepage = "https://github.com/grootle/muteAIMP"
+Repository = "https://github.com/grootle/muteAIMP"
+Issues = "https://github.com/grootle/muteAIMP/issues"
+
+[project.scripts]
+muteaimp = "muteaimp.main:main"
+
+[build-system]
+requires = ["uv_build>=0.12.9,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = ""