audio-spectrogram 0.1.0a0__py3-none-any.whl

audio_spectrogram/app/widgets/main_window.py

@@ -0,0 +1,44 @@
+# Copyright 2026 - 2026, Artur Drogunow and the Audio-Spectrogram contributors
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import sys
+
+from PySide6.QtWidgets import QMainWindow, QVBoxLayout, QWidget
+
+from audio_spectrogram import APP_TITLE, __version__
+
+from .control_panel_widget import ControlPanelWidget
+from .plot_widget import PlotWidget
+
+
+class MainWindow(QMainWindow):
+    def __init__(self) -> None:
+        super().__init__()
+
+        # variables
+
+        # widgets
+        self.control_panel_widget = ControlPanelWidget()
+        self.plot_widget = PlotWidget()
+
+        # setup
+        self._setup_widgets()
+        self._setup_layout()
+        self._connect_signals()
+
+    def _setup_widgets(self) -> None:
+        title = (
+            f"{APP_TITLE} {__version__} "
+            f"(Python {sys.version_info[0]}.{sys.version_info[1]}.{sys.version_info[2]})"
+        )
+        self.setWindowTitle(title)
+
+    def _setup_layout(self) -> None:
+        central_widget = QWidget()
+        self.setCentralWidget(central_widget)
+        vbox = QVBoxLayout(central_widget)
+        vbox.addWidget(self.control_panel_widget, 0)
+        vbox.addWidget(self.plot_widget, 1)
+
+    def _connect_signals(self) -> None:
+        pass

audio_spectrogram/app/widgets/plot_widget.py

@@ -0,0 +1,58 @@
+# Copyright 2026 - 2026, Artur Drogunow and the Audio-Spectrogram contributors
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import pyqtgraph as pg
+from PySide6.QtWidgets import QGroupBox, QVBoxLayout
+
+pg.setConfigOption(opt="useNumba", value=True)
+
+
+class PlotWidget(QGroupBox):
+    def __init__(self) -> None:
+        super().__init__("Signal Viewer")
+
+        # variables
+
+        # widgets
+        self.glw = pg.GraphicsLayoutWidget()
+        self.time_plot = self.glw.addPlot(row=0, col=0)
+        self.time_plot_item = pg.PlotCurveItem()
+        self.spec_plot = self.glw.addPlot(row=1, col=0)
+        self.spec_plot_item = pg.ImageItem(axisOrder="row-major", levels=[-90, 0])
+
+        # setup
+        self._setup_widgets()
+        self._setup_layout()
+        self._connect_signals()
+
+    def _setup_widgets(self) -> None:
+        # set line properties
+        self.time_plot_item.setClickable(False)
+        self.time_plot_item.setPen(pg.mkPen("coral", width=0.5))
+        self.time_plot_item.setSkipFiniteCheck(True)
+        self.time_plot_item.setSegmentedLineMode("on")
+
+        # horizontally align left axis
+        self.time_plot.getAxis("left").setWidth(40)
+        self.spec_plot.getAxis("left").setWidth(40)
+
+        # setup time plot
+        self.time_plot.setLabel("left", "Amplitude")
+        self.time_plot.setLabel("bottom", "Time", units="s")
+        self.time_plot.showGrid(x=True, y=True)
+        self.time_plot.addItem(self.time_plot_item)
+
+        # setup spectrum plot
+        self.spec_plot.setYRange(-100, 7100)
+        self.spec_plot.setLabel("left", "Frequency", units="Hz")
+        self.spec_plot.setLabel("bottom", "Time", units="s")
+        self.spec_plot.showGrid(x=False, y=False)
+        self.spec_plot_item.setColorMap(pg.colormap.get("magma"))
+        self.spec_plot.addItem(self.spec_plot_item)
+
+    def _setup_layout(self) -> None:
+        layout = QVBoxLayout(self)
+        layout.addWidget(self.glw)
+
+    def _connect_signals(self) -> None:
+        pass

audio_spectrogram/app/widgets/power_of_two_spinbox.py

@@ -0,0 +1,42 @@
+# Copyright 2026 - 2026, Artur Drogunow and the Audio-Spectrogram contributors
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import typing
+
+from PySide6.QtWidgets import (
+    QSpinBox,
+    QWidget,
+)
+
+DEFAULT_VALUE: typing.Final = 1024
+MIN_VALUE: typing.Final = 64
+
+
+class PowerOfTwoSpinBox(QSpinBox):
+    def __init__(self, parent: QWidget | None = None) -> None:
+        super().__init__(parent)
+
+        self.setReadOnly(True)
+        self.setRange(MIN_VALUE, 2**30)
+        self.setValue(1024)  # default value
+
+    @typing.override
+    def stepBy(self, steps: int, /) -> None:
+        value: int = self.value()
+
+        for _ in range(abs(steps)):
+            if steps > 0:
+                value *= 2
+            else:
+                value = max(MIN_VALUE, value // 2)
+
+        self.setValue(value)
+
+    @typing.override
+    def stepEnabled(self, /) -> QSpinBox.StepEnabledFlag:
+        flags = QSpinBox.StepEnabledFlag.StepUpEnabled
+
+        if self.value() > MIN_VALUE:
+            flags |= QSpinBox.StepEnabledFlag.StepDownEnabled
+
+        return flags

audio_spectrogram/util.py

@@ -0,0 +1,63 @@
+# Copyright 2026 - 2026, Artur Drogunow and the Audio-Spectrogram contributors
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import datetime
+import logging
+from typing import Final
+
+from platformdirs import user_log_path
+
+from audio_spectrogram import APP_TITLE, LOGGER, PACKAGE_NAME
+
+VERBOSITY_LEVEL_APP_DEBUG: Final = 1
+VERBOSITY_LEVEL_ROOT_WARNING: Final = 1
+VERBOSITY_LEVEL_ROOT_INFO: Final = 2
+VERBOSITY_LEVEL_ROOT_DEBUG: Final = 3
+
+
+def setup_logging(verbosity: int) -> None:
+    iso_date = datetime.datetime.now(tz=datetime.UTC).strftime("%Y-%m-%d")
+    logfile_path = user_log_path(PACKAGE_NAME, ensure_exists=True) / f"{iso_date}.log"
+
+    with logfile_path.open(mode="at") as file:
+        if file.tell() > 0:
+            file.write("\n\n")
+        file.writelines(
+            [
+                "*" * 80 + "\n",
+                f"Start {APP_TITLE}".center(80) + "\n",
+                "*" * 80 + "\n",
+            ]
+        )
+
+    # instantiate logging handlers
+    file_handler = logging.FileHandler(logfile_path)
+    stream_handler = logging.StreamHandler()
+
+    # configure formatting
+    formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+    file_handler.setFormatter(formatter)
+    stream_handler.setFormatter(formatter)
+
+    # determine log levels for app (package_level) and dependencies (root_level)
+    package_level = logging.DEBUG if verbosity >= VERBOSITY_LEVEL_APP_DEBUG else logging.INFO
+    if verbosity >= VERBOSITY_LEVEL_ROOT_DEBUG:
+        root_level = logging.DEBUG
+    elif verbosity >= VERBOSITY_LEVEL_ROOT_INFO:
+        root_level = logging.INFO
+    elif verbosity >= VERBOSITY_LEVEL_ROOT_WARNING:
+        root_level = logging.WARNING
+    else:
+        root_level = logging.ERROR
+
+    # configure root logger
+    root_logger = logging.getLogger()
+    root_logger.handlers.clear()
+    root_logger.setLevel(root_level)
+    root_logger.addHandler(file_handler)
+    root_logger.addHandler(stream_handler)
+
+    # configure package logger
+    LOGGER.setLevel(package_level)
+    LOGGER.info("Root log level: %s", logging.getLevelName(root_level))
+    LOGGER.info("Package log level: %s", logging.getLevelName(package_level))

audio_spectrogram-0.1.0a0.dist-info/METADATA

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: audio-spectrogram
+Version: 0.1.0a0
+Summary: Audio spectrogram app based on PySide6
+Author-email: Artur Drogunow <Artur.Drogunow@zf.com>
+License: GPL-3.0-or-later
+Keywords: Audio,Microphone,FFT,STFT,Spectrogram,Sonogram
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numba==0.65.*
+Requires-Dist: numpy==2.4.*
+Requires-Dist: platformdirs==4.9.*
+Requires-Dist: pyqtgraph==0.14.*
+Requires-Dist: pyside6==6.11.*
+Requires-Dist: rocket-fft==0.3.*
+Dynamic: license-file
+
+# Audio Spectrogram
+
+[![PyPI - Version](https://img.shields.io/pypi/v/audio-spectrogram.svg)](https://pypi.org/project/audio-spectrogram)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/audio-spectrogram.svg)](https://pypi.org/project/audio-spectrogram)
+
+## Introduction
+
+*Audio Spectrogram* is a small python GUI application to analyze the frequency content of your microphone input.
+
+<img src="doc/GUI.png" width="683" alt="GUI Screenshot" />
+
+## Usage
+
+You can run it directly from your command line:
+```bash
+uvx audio-spectrogram
+```
+or
+```bash
+pipx audio-spectrogram
+```

audio_spectrogram-0.1.0a0.dist-info/RECORD

@@ -0,0 +1,21 @@
+audio_spectrogram/__init__.py,sha256=5EDkWGwK2wElA1YUBkPjBbDX6MHrcKcLYSAUIxT6PhE,370
+audio_spectrogram/__main__.py,sha256=Ss1Tm75zZmuX_pQqJuLa76nPwhUj7gBe-Mz5ObDssvs,910
+audio_spectrogram/util.py,sha256=VuKBtd6rgnKkaDZx6t0wh1Ff-ZQywBLgkMqNMOzP4NE,2185
+audio_spectrogram/app/__init__.py,sha256=-Og5GFBNZ-JabE4MKs8oKmad2KLKLljI_L8a_m_8CPY,123
+audio_spectrogram/app/application.py,sha256=GuZSet7Im-bn_EWOQUXd9qzgrIwZbkkvhTNQYqtzYkQ,2818
+audio_spectrogram/app/control_panel_handler.py,sha256=R1RpaZcrf_4VwOaXB4ouYnEGqbqYuiGeNaJAvH0bF00,6271
+audio_spectrogram/app/plot_handler.py,sha256=HBYyzF_eF2PFSvQQOKuadFaOQtMROYwd1XOZRhkBDR0,3824
+audio_spectrogram/app/qapplication.py,sha256=QO9oYPxgxZbdLS13qXS9VCuFr7gPbp0cAo4UyvAlLnc,606
+audio_spectrogram/app/spectrogram.py,sha256=YBJMjsmU72UugLNRvXbdliqviJR4b7ivWyVJJwCQ6xM,2387
+audio_spectrogram/app/widgets/__init__.py,sha256=-Og5GFBNZ-JabE4MKs8oKmad2KLKLljI_L8a_m_8CPY,123
+audio_spectrogram/app/widgets/combobox.py,sha256=bOdtX3y8_oLMdlBMHKK19rKhwMmGe_4zQreDyY4E-b0,1246
+audio_spectrogram/app/widgets/control_panel_widget.py,sha256=zCGpE-Qb57v5fvq9gDQftyRKJgHUAGNg35JCXSq-79I,4410
+audio_spectrogram/app/widgets/main_window.py,sha256=AxlhEqKGiXXgUClBv77vVICb-o9_jJw0JRmyYY_j4lY,1228
+audio_spectrogram/app/widgets/plot_widget.py,sha256=aQkKOEXKdfrW1wLKBN8qh3GTL7h11IpeP8ljxnvtVXI,1997
+audio_spectrogram/app/widgets/power_of_two_spinbox.py,sha256=h97FCkDcCk_jXOk07o2138QQpQQNLAer_3RgL92qP30,1062
+audio_spectrogram-0.1.0a0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+audio_spectrogram-0.1.0a0.dist-info/METADATA,sha256=PwYynoDRiFn3QNyiow-dv4CdTBRNWjhkVvf12sVObnQ,1556
+audio_spectrogram-0.1.0a0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+audio_spectrogram-0.1.0a0.dist-info/entry_points.txt,sha256=oxX9sLt6MdCumXmxR4xZn7iVaKSDUMETA_LiRN7hw0M,139
+audio_spectrogram-0.1.0a0.dist-info/top_level.txt,sha256=HcjNccVeBlauPVpuVzz1qMRDiYT3YKpyHMJH2s6_f1A,18
+audio_spectrogram-0.1.0a0.dist-info/RECORD,,

audio_spectrogram-0.1.0a0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

audio_spectrogram-0.1.0a0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+audio_spectrogram_c = audio_spectrogram.__main__:main
+
+[gui_scripts]
+audio_spectrogram = audio_spectrogram.__main__:main