Merge branch 'master' into python-json

Author: bzaczynski

python-guitar-synthesizer/README.md

@@ -0,0 +1,3 @@
+# Build a Guitar Synthesizer: Play Musical Tablature in Python
+
+This folder contains the source code and resources for the Real Python tutorial [Build a Guitar Synthesizer: Play Musical Tablature in Python](https://realpython.com/python-guitar-synthesizer/).

python-guitar-synthesizer/source_code_final/README.md

@@ -0,0 +1,37 @@
+# Digitar
+
+A digital guitar and a tablature player.
+
+## Installation
+
+Install the project along with its dependencies into a virtual environment managed by Poetry:
+
+```sh
+$ poetry install
+```
+
+## Usage
+
+Activate the project's virtual environment: 
+
+```sh
+$ poetry shell
+```
+
+Change directory to the `demo/` subfolder and run the sample scripts:
+
+```sh
+(digitar-py3.12) $ cd demo/
+(digitar-py3.12) $ python play_chorus.py
+(digitar-py3.12) $ python play_diablo.py
+```
+
+Read the tablature from the custom YAML file format:
+
+```sh
+$ play-tab tabs/doom.yaml 
+Saved file /home/user/digital-guitar/demo/doom.mp3
+
+$ play-tab tabs/foggy-mountain-breakdown.yaml -o foggy.mp3
+Saved file /home/user/digital-guitar/demo/foggy.mp3
+```

python-guitar-synthesizer/source_code_final/demo/ir/ATTRIBUTION.md

@@ -0,0 +1,21 @@
+# Impulse Responses
+
+1. Acoustic Guitar
+    - File: `Tay816 M251 SB1.wav`
+    - URL: https://worshiptutorials.com/product/acoustic-ir-sample-pack/
+
+2. Banjo
+    - File: `IR_5_string_banjo_dazzo_IR44k.wav`
+    - URL: https://acousticir.free.fr/spip.php
+
+3. Bass Guitar
+    - File: `Holy Grail C800 SB1.wav`
+    - https://worshiptutorials.com/product/acoustic-ir-sample-pack/
+
+4. Electric Guitar
+    - File: `Rocksta Reactions Mesa Traditional D6 D 0 -18 -36.wav`
+    - URL: https://www.soundwoofer.se/blog/about/top-20-list/
+
+5. Ukulele
+    - File: `AtlasV2.wav`
+    - URL: https://liveukulele.com/lessons/plug-in/impulse-response-tutorial/