added playing & recording audio tutorial

Author: x4nth055

general/recording-and-playing-audio/README.md

@@ -0,0 +1,28 @@
+# [How to Play and Record Audio in Python](https://www.thepythoncode.com/article/play-and-record-audio-sound-in-python)
+To run this:
+- `pip3 install -r requirements.txt`
+- To record audio:
+    ```
+    python audio_recorder.py --help
+    ```
+    **Output:**
+    ```
+    usage: audio_recorder.py [-h] [-o OUTPUT] [-d DURATION]
+
+    an Audio Recorder using Python
+
+    optional arguments:
+    -h, --help            show this help message and exit
+    -o OUTPUT, --output OUTPUT
+                            Output file (with .wav)
+    -d DURATION, --duration DURATION
+                            Duration to record in seconds (can be float)
+    ```
+    For instance, you want to record 5 seconds and save it to `recorded.wav` file:
+    ```
+    python audio_recorder.py -d 5 -o recorded.wav
+    ```
+- To play audio, there are 3 options (`audio_player_1.py` using [playsound](), `audio_player_2.py` using [pydub](), `audio_player_3.py` using [pyaudio]()):
+    ```
+    python audio_player.py --help
+    ```

general/recording-and-playing-audio/audio_file.mp3

@@ -0,0 +1,3 @@
+from playsound import playsound
+
+playsound("recorded.wav")

general/recording-and-playing-audio/audio_file.wav

@@ -0,0 +1,32 @@
+import pyaudio
+import wave
+
+filename = "audio_file.wav"
+
+# set the chunk size of 1024 samples
+chunk = 1024
+
+# open the audio file
+wf = wave.open(filename, "rb")
+
+# initialize PyAudio object
+p = pyaudio.PyAudio()
+
+# open stream object
+stream = p.open(format=p.get_format_from_width(wf.getsampwidth()),
+                channels=wf.getnchannels(),
+                rate=wf.getframerate(),
+                output=True)
+
+# read data in chunks
+data = wf.readframes(chunk)
+
+# writing to the stream (playing audio)
+while data:
+    stream.write(data)
+    data = wf.readframes(chunk)
+
+# close stream
+stream.close()
+p.terminate()
+                

general/recording-and-playing-audio/audio_player_playsound.py

@@ -0,0 +1,9 @@
+from pydub import AudioSegment
+from pydub.playback import play
+
+# read MP3 file
+song = AudioSegment.from_mp3("audio_file.mp3")
+# song = AudioSegment.from_wav("audio_file.wav")
+# you can also read from other formats such as MP4
+# song = AudioSegment.from_file("audio_file.mp4", "mp4")
+play(song)

general/recording-and-playing-audio/audio_player_pyaudio.py

@@ -0,0 +1,61 @@
+import pyaudio
+import wave
+import argparse
+
+parser = argparse.ArgumentParser(description="an Audio Recorder using Python")
+parser.add_argument("-o", "--output", help="Output file (with .wav)", default="recorded.wav")
+parser.add_argument("-d", "--duration", help="Duration to record in seconds (can be float)", default=5)
+
+args = parser.parse_args()
+# the file name output you want to record into
+filename = args.output
+# number of seconds to record
+record_seconds = float(args.duration)
+
+# set the chunk size of 1024 samples
+chunk = 1024
+# sample format
+FORMAT = pyaudio.paInt16
+# mono, change to 2 if you want stereo
+channels = 1
+# 44100 samples per second
+sample_rate = 44100
+
+# initialize PyAudio object
+p = pyaudio.PyAudio()
+
+# open stream object as input & output
+stream = p.open(format=FORMAT,
+                channels=channels,
+                rate=sample_rate,
+                input=True,
+                output=True,
+                frames_per_buffer=chunk)
+
+frames = []
+print("Recording...")
+for i in range(int(44100 / chunk * record_seconds)):
+    data = stream.read(chunk)
+    # if you want to hear your voice while recording
+    # stream.write(data)
+    frames.append(data)
+print("Finished recording.")
+# stop and close stream
+stream.stop_stream()
+stream.close()
+# terminate pyaudio object
+p.terminate()
+
+# save audio file
+# open the file in 'write bytes' mode
+wf = wave.open(filename, "wb")
+# set the channels
+wf.setnchannels(channels)
+# set the sample format
+wf.setsampwidth(p.get_sample_size(FORMAT))
+# set the sample rate
+wf.setframerate(sample_rate)
+# write the frames as bytes
+wf.writeframes(b"".join(frames))
+# close the file
+wf.close()

general/recording-and-playing-audio/audio_player_pydub.py

@@ -0,0 +1,4 @@
+playsound
+pyaudio
+pydub
+ffmpeg-python