ay8910-wrapper 0.7.2__tar.gz

ay8910_wrapper-0.7.2/.github/workflows/build_and_publish.yml

@@ -0,0 +1,66 @@
+name: Build and Publish Wheels
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+env:
+  # Force GitHub Actions to use Node.js 24 as per the deprecation warning
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  build_wheels:
+    name: Build wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.4.1
+        env:
+          CIBW_PRERELEASE_PYTHONS: True
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
+          path: ./wheelhouse/*.whl
+
+  build_sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build sdist
+        run: pipx run build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: Publish to PyPI
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    # Required for Trusted Publishing
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: cibw-*
+          path: dist
+          merge-multiple: true
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true

ay8910_wrapper-0.7.2/.github/workflows/tests.yml

@@ -0,0 +1,65 @@
+name: Tests & Linting
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+  workflow_dispatch:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  lint:
+    name: Python Linting
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install ruff
+
+      - name: Run Ruff
+        run: ruff check .
+
+  test:
+    name: Build & Test on ${{ matrix.os }} (Py ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    needs: lint
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.8", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: "pip"
+
+      - name: Install system dependencies (Ubuntu)
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libportaudio2
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install .[test]
+
+      - name: Run tests
+        run: pytest tests/

ay8910_wrapper-0.7.2/.gitignore

@@ -0,0 +1,48 @@
+# --- SECURITY (CRITICAL) ---
+.env
+.env.local
+.env.*.local
+*.pem
+*.key
+.secrets.baseline
+
+# --- PYTHON ---
+__pycache__/
+*.py[cod]
+*$py.class
+.venv
+venv/
+ENV/
+env/
+build/
+dist/
+*.egg-info/
+
+# --- TESTS & QUALITY ---
+.pytest_cache/
+.tox/
+.nox/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# --- DOCKER ---
+.docker/
+# We keep the Dockerfile, but we mostly forget the persistent data
+data/
+db_data/
+
+# --- IDE (VS Code, PyCharm) ---
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# --- OS ---
+.DS_Store
+Thumbs.db
+
+# --- PROJECT SPECIFICS --
+YM example files/
+*.wav

ay8910_wrapper-0.7.2/CMakeLists.txt

@@ -0,0 +1,38 @@
+cmake_minimum_required(VERSION 3.15)
+
+# Silence the pybind11 deprecation warning
+cmake_policy(SET CMP0148 NEW)
+
+project(ay8910_wrapper CXX)
+
+# --- C++ Standard ---
+# The MAME code uses C++17 features (like if-initializers)
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# --- C++ Library ---
+# Define our standalone C++ library
+add_library(ay8910_cpp_lib
+    ay8910_cpp_lib/ay8910.cpp
+    ay8910_cpp_lib/ay8912_cap32.cpp
+)
+# Specify its include directory
+target_include_directories(ay8910_cpp_lib PUBLIC ay8910_cpp_lib)
+
+# Enable Position Independent Code (-fPIC) for the static library,
+# required to link it into the shared Python module on Linux.
+set_target_properties(ay8910_cpp_lib PROPERTIES POSITION_INDEPENDENT_CODE ON)
+
+# --- Python Module ---
+# Find pybind11 (provided by scikit-build-core)
+find_package(pybind11 CONFIG REQUIRED)
+
+# Define the Python module using our wrapper and linking to our C++ library
+pybind11_add_module(ay8910_wrapper
+    src/ay8910_wrapper/wrapper.cpp
+)
+target_link_libraries(ay8910_wrapper PRIVATE ay8910_cpp_lib)
+
+# --- Installation ---
+# This tells scikit-build where to install the final .pyd file
+install(TARGETS ay8910_wrapper DESTINATION ay8910_wrapper)

ay8910_wrapper-0.7.2/CONTRIBUTE.md

@@ -0,0 +1,131 @@
+# Contributing Guide
+
+Thank you for your interest in `ay8910_wrapper`! This document explains how to contribute to the project.
+
+## GitHub Flow
+
+We follow the standard **GitHub Flow** for development. Here is a concrete example of the commands to use:
+
+1.  **Fork the repository** on GitHub by clicking the "Fork" button.
+2.  **Clone your fork** locally:
+    ```powershell
+    git clone https://github.com/YOUR_USERNAME/ay8910.git
+    cd ay8910
+    ```
+3.  **Keep your fork up to date** (to be done before each new modification):
+    If you haven't added the **original** (upstream) repository yet:
+    ```powershell
+    git remote add upstream https://github.com/devfred78/ay8910.git
+    ```
+    Then, synchronize your `main` branch:
+    ```powershell
+    git checkout main
+    git fetch upstream
+    git merge upstream/main
+    git push origin main
+    ```
+4.  **Create a descriptive branch** for your modification:
+    ```powershell
+    git checkout -b fix-envelope-bug
+    ```
+5.  **Make your changes** and commit them:
+    ```powershell
+    # After editing files
+    git add .
+    git commit -m "Fix: correct envelope period calculation in ay8912_cap32"
+    ```
+6.  **Push** your branch to your fork:
+    ```powershell
+    git push origin fix-envelope-bug
+    ```
+7.  **Open a Pull Request (PR)**: Go to the original repository on GitHub. You should see a "Compare & pull request" button for your recently pushed branch.
+
+### Handling Merge Conflicts
+
+Sometimes, GitHub may detect conflicts in your Pull Request because someone else modified the same lines of code in the `main` branch. To resolve them, you need to synchronize your local repository with the **original** (upstream) repository (as described in step 3 above) and merge it into your branch:
+
+1.  **Update your local `main` branch from upstream** (see step 3 for details).
+
+2.  **Merge `main` into your feature branch**:
+    ```powershell
+    git checkout fix-envelope-bug
+    git merge main
+    ```
+
+3.  **Resolve conflicts**: Git will mark the files with conflicts. Open them in your editor, look for `<<<<<<<`, `=======`, and `>>>>>>>` markers, and choose which version to keep.
+
+4.  **Commit the resolution**:
+    ```powershell
+    git add .
+    git commit -m "Merge main and resolve conflicts"
+    ```
+
+5.  **Push the updated branch**:
+    ```powershell
+    git push origin fix-envelope-bug
+    ```
+    The Pull Request will be updated automatically on GitHub.
+
+## Development Environment Setup
+
+We recommend using **[uv](https://github.com/astral-sh/uv)** for fast and efficient management of Python virtual environments.
+
+### 1. Install `uv`
+If you don't have `uv` yet, install it:
+- **Windows**: `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"`
+- **macOS/Linux**: `curl -LsSf https://astral.sh/uv/install.sh | sh`
+
+### 2. Initialize the Environment
+From the project root:
+```powershell
+# Create the virtual environment and install development dependencies
+uv sync --all-extras
+```
+
+This command automatically installs the dependencies needed for:
+- Compiling the C++ extension
+- Running tests (`pytest`)
+- Linting (`ruff`)
+
+## Development and Compilation
+
+As the project contains a C++ extension, you need to compile it to test your modifications:
+
+```powershell
+# Install in editable mode (compiles the C++ module)
+uv pip install -e .
+```
+
+If you modify the C++ code (`src/ay8910_wrapper/wrapper.cpp` or files in `ay8910_cpp_lib/`), you will need to rerun this command for the changes to take effect in Python.
+
+## Unit Tests
+
+### Run Tests Locally
+Before submitting a PR, make sure all tests pass:
+
+```powershell
+# Run all tests with pytest
+uv run pytest tests/
+```
+
+### Linting
+We use `ruff` to ensure code quality:
+```powershell
+# Check code style
+uv run ruff check .
+```
+
+## Continuous Integration (GitHub Actions)
+
+When a Pull Request is opened, the following actions are automatically launched on GitHub:
+
+1.  **Linting**: Code style check with `ruff`.
+2.  **Build & Test**: 
+    - Compilation of the project on **Linux, Windows, and macOS**.
+    - Execution of unit tests on **Python 3.8 and 3.13** versions.
+
+Additionally, when a **version tag** (starting with `v`) is pushed to the repository, the **Build and Publish** workflow is triggered to automatically build wheels for all platforms and publish them to **PyPI**.
+
+---
+
+Once your modification is ready and tested, feel free to submit your Pull Request!

ay8910_wrapper-0.7.2/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 devfred78
+
+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.

ay8910_wrapper-0.7.2/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.2
+Name: ay8910_wrapper
+Version: 0.7.2
+Summary: A Python wrapper for the AY-3-8910 and AY-3-8912 sound chip emulators, featuring real-time audio playback and cycle-accurate synthesis.
+Author-Email: devfred78 <devfred78@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: C++
+Project-URL: Homepage, https://github.com/devfred78/ay8910
+Requires-Python: >=3.8
+Requires-Dist: lhafile
+Requires-Dist: numpy>=1.24.4
+Requires-Dist: sounddevice>=0.5.5
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Description-Content-Type: text/markdown
+
+# AY-3-8910 Standalone Library and Python Wrapper
+
+A Python wrapper for the AY-3-8910 and AY-3-8912 sound chip emulators, featuring real-time audio playback and cycle-accurate synthesis.
+
+> **A Note on this Project's Origin**
+>
+> This project is primarily the result of a series of experiments using various IA Code Assists for code generation and error handling. Rather than using it on academic examples, it seemed more interesting to apply it to a project that could meet a real practical need.
+>
+> This, therefore, is the reason for `AY8910`'s existence: you can dissect the code to see how Gemini and Junie (with my guidance) went about building it, or you can ignore all that and just use this library for your own needs!
+
+This project contains a standalone C++ library for the AY-3-8910 sound chip. It features two emulation engines:
+- **Caprice32-based (`ay8912_cap32`)**: The **recommended** engine for all new projects. It offers superior accuracy, stereo mixing, and integrated live audio support.
+- **MAME-based (`ay8910`)**: Kept primarily for **historical reasons** and legacy compatibility.
+
+It also includes a Python wrapper to make these emulators accessible from Python scripts, allowing for programmatic chiptune generation and `.ym` file playback.
+
+## Quick Start (Live Audio)
+
+```python
+import ay8910_wrapper as ay
+import time
+
+# Initialize
+psg = ay.ay8912_cap32(1000000, 44100)
+psg.set_stereo_mix(255, 13, 170, 170, 13, 255)
+
+# Start live playback!
+psg.play()
+
+# Set registers - sound changes immediately
+psg.set_register(0, 254) # Tone A Fine
+psg.set_register(1, 0)   # Tone A Coarse
+psg.set_register(7, 0x3E) # Enable Channel A
+psg.set_register(8, 15)   # Max volume
+
+time.sleep(1)
+psg.stop()
+```
+
+```sh
+# Play a .ym file using the new live script
+python scripts\ym_live_player.py PATH\TO\YM_FILE.YM
+```
+
+## Installation
+
+You can install the library directly from [PyPI](https://pypi.org/project/ay8910-wrapper/):
+
+```sh
+pip install ay8910_wrapper
+```
+
+This will automatically install the necessary dependencies (`lhafile`, `numpy`, `sounddevice`).
+
+For developers who want to compile from source or contribute, please refer to the [Contributing Guide](CONTRIBUTE.md).
+
+## Basic Usage in Python (Legacy MAME engine)
+
+> **Note**: This section demonstrates the legacy `ay8910` class. For modern applications, please refer to the **Quick Start** section or the **Caprice32** section below.
+
+```python
+import ay8910_wrapper as ay
+import wave
+import struct
+
+# Helper to write WAV files
+def write_wav(filename, samples, sample_rate):
+    with wave.open(filename, 'wb') as f:
+        f.setnchannels(1)
+        f.setsampwidth(2)
+        f.setframerate(sample_rate)
+        packed_samples = struct.pack('<' + 'h' * len(samples), *samples)
+        f.writeframes(packed_samples)
+
+# --- Main Program ---
+
+# 1. Initialize the emulator
+clock = 2000000  # 2 MHz, a common clock for this chip
+sample_rate = 44100
+psg = ay.ay8910(ay.psg_type.PSG_TYPE_AY, clock, 1, 0)
+psg.set_flags(ay.AY8910_LEGACY_OUTPUT)
+psg.start()
+psg.reset()
+
+# 2. Program the chip registers
+# Enable Tone on Channel A, disable everything else
+psg.address_w(7)
+psg.data_w(0b00111110)
+
+# Set Channel A frequency to Middle C (261.63 Hz)
+period = int(clock / (16 * 261.63))
+psg.address_w(0)  # Fine tune
+psg.data_w(period & 0xFF)
+psg.address_w(1)  # Coarse tune
+psg.data_w((period >> 8) & 0x0F)
+
+# Set Channel A volume to max
+psg.address_w(8)
+psg.data_w(15)
+
+# 3. Generate audio
+# Generate 2 seconds of audio
+num_samples = sample_rate * 2
+samples = psg.generate(num_samples, sample_rate)
+
+# 4. Save the result
+write_wav("tone_output.wav", samples, sample_rate)
+print("Generated 'tone_output.wav'")
+
+```
+
+For a complete list of all available functions, classes, and constants, please see the [API Reference](REFERENCE.md).
+
+## Recommended: Caprice32 (Amstrad CPC) Emulation
+
+The **Caprice32** engine is the preferred choice for most users. It provides more authentic sound synthesis and advanced features like stereo panning.
+
+```python
+# Initialize the Caprice32-style emulator
+psg_cpc = ay.ay8912_cap32(clock, sample_rate)
+# Set standard CPC stereo mix (Channel A=Left, B=Center, C=Right)
+psg_cpc.set_stereo_mix(255, 13, 170, 170, 13, 255)
+
+# Generate stereo audio (interleaved)
+stereo_samples = psg_cpc.generate(num_samples)
+```
+
+## Contributing Guide
+
+If you wish to contribute to the project or compile it from source, please refer to our **[Contributing Guide](CONTRIBUTE.md)**.
+
+It contains all the necessary information about:
+- The development workflow (**GitHub Flow**)
+- Using **uv** for environment management
+- Compilation and test commands
+- Continuous integration processes (GitHub Actions)
+
+## Acknowledgments
+
+This project relies on the incredible work of the following open-source projects:
+
+- **[MAME](https://github.com/mamedev/mame)**: The original AY-3-8910 and YM2149 emulation cores were derived from the MAME project. Their commitment to accuracy and historical preservation is a cornerstone of this library.
+- **[Caprice32](https://github.com/ColinPitrat/caprice32)**: The Amstrad CPC-specific PSG emulation logic and amplitude tables were integrated from the Caprice32 project, providing authentic sound for CPC-related audio tasks.
+- **[Sergey Bulba](http://bulba.at.gz.ru/)**: Special thanks for the AY/YM amplitude tables used in the Caprice32 engine, which are essential for reproducing the characteristic sound of these chips.

ay8910_wrapper-0.7.2/README.md

@@ -0,0 +1,144 @@
+# AY-3-8910 Standalone Library and Python Wrapper
+
+A Python wrapper for the AY-3-8910 and AY-3-8912 sound chip emulators, featuring real-time audio playback and cycle-accurate synthesis.
+
+> **A Note on this Project's Origin**
+>
+> This project is primarily the result of a series of experiments using various IA Code Assists for code generation and error handling. Rather than using it on academic examples, it seemed more interesting to apply it to a project that could meet a real practical need.
+>
+> This, therefore, is the reason for `AY8910`'s existence: you can dissect the code to see how Gemini and Junie (with my guidance) went about building it, or you can ignore all that and just use this library for your own needs!
+
+This project contains a standalone C++ library for the AY-3-8910 sound chip. It features two emulation engines:
+- **Caprice32-based (`ay8912_cap32`)**: The **recommended** engine for all new projects. It offers superior accuracy, stereo mixing, and integrated live audio support.
+- **MAME-based (`ay8910`)**: Kept primarily for **historical reasons** and legacy compatibility.
+
+It also includes a Python wrapper to make these emulators accessible from Python scripts, allowing for programmatic chiptune generation and `.ym` file playback.
+
+## Quick Start (Live Audio)
+
+```python
+import ay8910_wrapper as ay
+import time
+
+# Initialize
+psg = ay.ay8912_cap32(1000000, 44100)
+psg.set_stereo_mix(255, 13, 170, 170, 13, 255)
+
+# Start live playback!
+psg.play()
+
+# Set registers - sound changes immediately
+psg.set_register(0, 254) # Tone A Fine
+psg.set_register(1, 0)   # Tone A Coarse
+psg.set_register(7, 0x3E) # Enable Channel A
+psg.set_register(8, 15)   # Max volume
+
+time.sleep(1)
+psg.stop()
+```
+
+```sh
+# Play a .ym file using the new live script
+python scripts\ym_live_player.py PATH\TO\YM_FILE.YM
+```
+
+## Installation
+
+You can install the library directly from [PyPI](https://pypi.org/project/ay8910-wrapper/):
+
+```sh
+pip install ay8910_wrapper
+```
+
+This will automatically install the necessary dependencies (`lhafile`, `numpy`, `sounddevice`).
+
+For developers who want to compile from source or contribute, please refer to the [Contributing Guide](CONTRIBUTE.md).
+
+## Basic Usage in Python (Legacy MAME engine)
+
+> **Note**: This section demonstrates the legacy `ay8910` class. For modern applications, please refer to the **Quick Start** section or the **Caprice32** section below.
+
+```python
+import ay8910_wrapper as ay
+import wave
+import struct
+
+# Helper to write WAV files
+def write_wav(filename, samples, sample_rate):
+    with wave.open(filename, 'wb') as f:
+        f.setnchannels(1)
+        f.setsampwidth(2)
+        f.setframerate(sample_rate)
+        packed_samples = struct.pack('<' + 'h' * len(samples), *samples)
+        f.writeframes(packed_samples)
+
+# --- Main Program ---
+
+# 1. Initialize the emulator
+clock = 2000000  # 2 MHz, a common clock for this chip
+sample_rate = 44100
+psg = ay.ay8910(ay.psg_type.PSG_TYPE_AY, clock, 1, 0)
+psg.set_flags(ay.AY8910_LEGACY_OUTPUT)
+psg.start()
+psg.reset()
+
+# 2. Program the chip registers
+# Enable Tone on Channel A, disable everything else
+psg.address_w(7)
+psg.data_w(0b00111110)
+
+# Set Channel A frequency to Middle C (261.63 Hz)
+period = int(clock / (16 * 261.63))
+psg.address_w(0)  # Fine tune
+psg.data_w(period & 0xFF)
+psg.address_w(1)  # Coarse tune
+psg.data_w((period >> 8) & 0x0F)
+
+# Set Channel A volume to max
+psg.address_w(8)
+psg.data_w(15)
+
+# 3. Generate audio
+# Generate 2 seconds of audio
+num_samples = sample_rate * 2
+samples = psg.generate(num_samples, sample_rate)
+
+# 4. Save the result
+write_wav("tone_output.wav", samples, sample_rate)
+print("Generated 'tone_output.wav'")
+
+```
+
+For a complete list of all available functions, classes, and constants, please see the [API Reference](REFERENCE.md).
+
+## Recommended: Caprice32 (Amstrad CPC) Emulation
+
+The **Caprice32** engine is the preferred choice for most users. It provides more authentic sound synthesis and advanced features like stereo panning.
+
+```python
+# Initialize the Caprice32-style emulator
+psg_cpc = ay.ay8912_cap32(clock, sample_rate)
+# Set standard CPC stereo mix (Channel A=Left, B=Center, C=Right)
+psg_cpc.set_stereo_mix(255, 13, 170, 170, 13, 255)
+
+# Generate stereo audio (interleaved)
+stereo_samples = psg_cpc.generate(num_samples)
+```
+
+## Contributing Guide
+
+If you wish to contribute to the project or compile it from source, please refer to our **[Contributing Guide](CONTRIBUTE.md)**.
+
+It contains all the necessary information about:
+- The development workflow (**GitHub Flow**)
+- Using **uv** for environment management
+- Compilation and test commands
+- Continuous integration processes (GitHub Actions)
+
+## Acknowledgments
+
+This project relies on the incredible work of the following open-source projects:
+
+- **[MAME](https://github.com/mamedev/mame)**: The original AY-3-8910 and YM2149 emulation cores were derived from the MAME project. Their commitment to accuracy and historical preservation is a cornerstone of this library.
+- **[Caprice32](https://github.com/ColinPitrat/caprice32)**: The Amstrad CPC-specific PSG emulation logic and amplitude tables were integrated from the Caprice32 project, providing authentic sound for CPC-related audio tasks.
+- **[Sergey Bulba](http://bulba.at.gz.ru/)**: Special thanks for the AY/YM amplitude tables used in the Caprice32 engine, which are essential for reproducing the characteristic sound of these chips.