From 30bb0d91f7edaf5574f5578c762db3a025c5c0d9 Mon Sep 17 00:00:00 2001
From: Nick Pourazima <12181252+nickpourazima@users.noreply.github.com>
Date: Mon, 9 Oct 2023 21:27:53 -0600
Subject: [PATCH] feat: add installer script prompts (#15)

add time expired sound
update README
---
 README.md                |  90 +++++++++++++++++++++---------------
 audioInterface.py        |  10 ++--
 config.yaml              |   2 +-
 installer.sh             |  97 +++++++++++++++++++++++++++++++++++++++
 sounds/time_exceeded.wav | Bin 0 -> 43610 bytes
 5 files changed, 157 insertions(+), 42 deletions(-)
 create mode 100644 sounds/time_exceeded.wav

diff --git a/README.md b/README.md
index c91b3bb..b4d3ae1 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,20 @@
 # Rotary Phone Audio Guestbook
 
+This project transforms a rotary phone into a voice recorder for use at special events (i.e. wedding audio guestbook, etc.).
+
+![image](images/final_result_2.jpg)
+
 - [Rotary Phone Audio Guestbook](#rotary-phone-audio-guestbook)
   - [Background](#background)
-  - [Post-Event](#post-event)
-    - [Future Work (Action Items)](#future-work-action-items)
+  - [Post-Event Reflection](#post-event-reflection)
+  - [Future Enhancements](#future-enhancements)
+  - [Quick-Start](#quick-start)
   - [Materials](#materials)
   - [Hardware](#hardware)
     - [Wiring](#wiring)
       - [Hook](#hook)
       - [Phone Cord](#phone-cord)
-    - [Microphone Replacement (Optional)](#microphone-replacement-optional)
+    - [Optional: Microphone Replacement](#optional-microphone-replacement)
   - [Software](#software)
     - [Dev Environment](#dev-environment)
     - [Installation](#installation)
@@ -26,29 +31,34 @@
       - [Restart ALSA](#restart-alsa)
   - [Support](#support)
 
-This project transforms a rotary phone into a voice recorder for use at special events (i.e. wedding audio guestbook, etc.).
-
-![image](images/final_result_2.jpg)
-
 ## Background
 
-I was inspired by my own upcoming wedding to put together a DIY solution for an audio guestbook using a rotary phone. Most online rentals were charging $600 for an experience that didn't even offer the ability to add a custom voice mail and took about 4-6 weeks of turn around time to process the audio after the event. I tried to use as many parts that I had laying around to keep costs down. It worked out quite well and we were able to gather some very special voice messages.
+Inspired by my own upcoming wedding, I created a DIY solution for an audio guestbook using a rotary phone. With most online rentals charging exorbitant fees without offering custom voicemail options, I sought a more affordable and customizable solution. Here, I've detailed a guide on creating your own audio guestbook. If you have questions, don't hesitate to reach out.
 
-Below you will find a parts list and detailed setup guide. Please feel free to reach out to me with any questions.
+## Post-Event Reflection
 
-## Post-Event
+The real event provided insights into areas of improvement for the setup. For instance, introducing a recording time limit became essential after some younger attendees left lengthy messages, draining the battery. Depending on the situation, you might also consider connecting the setup directly to a 5V power supply.
 
-Since this was a trial by fire type of scenario there ended up being a few gotchas at the real event which I've since accounted for. Namely setting a time limit on the recording length as we had some youngsters leaving 5+ minute messages repeatedly and this ended up draining the battery. Alternatively, depending on your scenario, it might be preferable to attach directly to a 5V power supply.
+## Future Enhancements
 
-### Future Work (Action Items)
+In anticipation of my wedding, I had code in place to detect dialed numbers from the rotary encoder, allowing us to play special messages for specific guests based on their dialed combination. However, this required users to dial zero before leaving a voice message, introducing an extra step. We opted for simplicity, but if you're interested in expanding on this, you're welcome to explore further. The details of this operation mode are described in [Mode 2](#operation-mode-2-audioguestbookwithrotarydialer)
 
-A few weeks before the wedding I had the code registering dialed numbers from the rotary encoder with the goal of playing back special messages for certain guests who dialed a certain combination (i.e. dial an area code to hear a special message to my old roomates). The details of this operation mode are described in [Mode 2](#operation-mode-2-audioguestbookwithrotarydialer) below. In order to activate this mode I had to wait for input when the phone was off the hook. This required an extra step of dialing zero before leaving a normal voice message. In the end we decided to keep it simple and I've thus migrated this code to the dev branch along with the code to run through post-processing the audio in a separate process.
-If anyone is interested in expanding this please feel free.
+Additionally, threading the audio playback would be beneficial, allowing for a watchdog service to terminate the thread upon a hook callback. This would stop the message playback when a user hangs up.
 
-I would also like to thread the audio playback so I can have a monitor/watchdog service terminate the thread upon hook callback so that the message doesn't continue playing once the user hangs up.
+## Quick-Start
+
+To get started:
+
+```bash
+chmod +x installer.sh
+./installer.sh
+```
 
 ## Materials
 
+<details>
+  <summary>Parts List</summary>
+
 | Part                                                                                                                                                                                                                                                                                                                                      | Notes                                                                                                                                                                                                 | Quantity | Cost         |
 | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------ |
 | [rotary phone](https://www.ebay.com/b/Rotary-Dial-Telephone/38038/bn_55192308)                                                                                                                                                                                                                                                            | Estate/garage/yard sales are probably the best places to find once of these. Ideally one with a phone jack since we will be using these four wires extensively.                                       | 1        | $0.00-$60.00 |
@@ -66,6 +76,8 @@ I would also like to thread the audio playback so I can have a monitor/watchdog
 | ---                                                                                                                                                                                                                                                                                                                                       | **--- If replacing the built-it microphone ---**                                                                                                                                                      | ---      | ---          |
 | [LavMic](https://www.amazon.com/dp/B01N6P80OQ?ref=nb_sb_ss_w_as-reorder-t1_ypp_rep_k3_1_9&amp=&crid=15WZEWMZ17EM9&amp=&sprefix=saramonic)                                                                                                                                                                                                 | Optional: if you'd like to replace the carbon microphone. This is an omnidirectional lavalier mic and outputs via a 3.5mm TRS                                                                         | 1        | $24.95       |
 
+</details>
+
 ## Hardware
 
 ### Wiring
@@ -90,7 +102,7 @@ To accommodate either type, you'll need to update the `config.yaml` with the app
 
   ![image](images/pi_block_terminal_wiring.jpg)
 
-- _Note: the green wire was used for the experimental rotary encoder feature identified in the [future work](#future-work-action-items) section._
+- _Note: the green wire was used for the experimental rotary encoder feature identified in the [future work](#future-enhancements) section._
 
 | Rotary Phone Block Terminal         | Top-down view                                |
 | ----------------------------------- | -------------------------------------------- |
@@ -109,9 +121,11 @@ To accommodate either type, you'll need to update the `config.yaml` with the app
   - [Here's](https://superuser.com/questions/53957/what-do-alsa-devices-like-hw0-0-mean-how-do-i-figure-out-which-to-use) a good reference to device selection.
   - You can also check [this](https://stackoverflow.com/questions/32838279/getting-list-of-audio-input-devices-in-python) from Python.
 
-### Microphone Replacement (Optional)
+### Optional: Microphone Replacement
 
-I found the sound quality of the built-in [carbon microphone](https://en.wikipedia.org/wiki/Carbon_microphone) on the rotary phone to be quite lacking in terms of amplitude, dynamic range and overall vocal quality. I tried boosting the gain from the digital (ALSA driver) side but this introduced an incredible amount of noise as expected. I then approached this from the analog domain and tried alternative circuitry to boost the sound quality based off this [carbon-to-dynamic converter](https://www.circuits-diy.com/mic-converter-circuit/).
+For improved sound quality, consider replacing the built-in [carbon microphone](https://en.wikipedia.org/wiki/Carbon_microphone).
+
+I found the sound quality of the built-in mic on the rotary phone to be quite lacking in terms of amplitude, dynamic range and overall vocal quality. I tried boosting the gain from the digital (ALSA driver) side but this introduced an incredible amount of noise as expected. I then approached this from the analog domain and tried alternative circuitry to boost the sound quality based off this [carbon-to-dynamic converter](https://www.circuits-diy.com/mic-converter-circuit/).
 
 Might be worth a further investigation in the future since it retains the integrity of the original rotary phone.
 
@@ -140,40 +154,41 @@ To replace:
 
 - rpi image: [Rasbian](https://www.raspberrypi.com/documentation/computers/getting-started.html) w/ SSH enabled
 - rpi on same network as development machine
-- Desktop IDE: vscode w/ [SSH FS extension](https://marketplace.visualstudio.com/items?itemName=Kelvin.vscode-sshfs)
+- _Optional: vscode w/ [SSH FS extension](https://marketplace.visualstudio.com/items?itemName=Kelvin.vscode-sshfs)_
 
 [Here's](https://jayproulx.medium.com/headless-raspberry-pi-zero-w-setup-with-ssh-and-wi-fi-8ddd8c4d2742) a great guide to get the rpi setup headless w/ SSH & WiFi dialed in.
 
 ### Installation
 
-After cloning the repository, there's an installer script available to ease the setup process. This script takes care of several tasks:
+- On the networked rpi - clone the repository:
 
-1. Install required dependencies.
-2. Replace placeholders in the service file to adapt to your project directory.
-3. Move the modified service file to the systemd directory.
-4. Create necessary directories (recordings and sounds).
-5. Grant execution permissions to the Python scripts.
-6. Reload systemd, enable, and start the service.
+```bash
+git clone git@github.com:nickpourazima/rotary-phone-audio-guestbook.git
+cd rotary-phone-audio-guestbook
+```
 
-To run the installer, navigate to the project directory and execute:
+- Next, use the installer script for a hassle-free setup.:
 
 ```bash
 chmod +x installer.sh
 ./installer.sh
 ```
 
+- Note, this script takes care of several tasks:
+
+  1. Install required dependencies.
+  2. Populate config.yaml based on user input
+  3. Replace placeholders in the service file to adapt to your project directory.
+  4. Move the modified service file to the systemd directory.
+  5. Create necessary directories (recordings and sounds).
+  6. Grant execution permissions to the Python scripts.
+  7. Reload systemd, enable, and start the service.
+
 ### [audioGuestBook systemctl service](audioGuestBook.service)
 
-The provided service ensures the Python script starts on boot. The installer script will place this service file in the `/etc/systemd/system`` directory and modify paths according to your project directory.
+This service ensures smooth operation without manual intervention every time your Raspberry Pi boots up. The installer script will place this service file in the `/etc/systemd/system` directory and modify paths according to your project directory.
 
-To manually control the service:
-
-```sh
-sudo systemctl enable audioGuestBook.service
-sudo systemctl start audioGuestBook.service
-```
-
-This service ensures smooth operation without manual intervention every time your Raspberry Pi boots up.
+Manual control of the service is possible as it operates as any other [`.service` entity](https://www.freedesktop.org/software/systemd/man/systemd.service.html)
 
 ### [Config](config.yaml)
 
@@ -197,9 +212,10 @@ This service ensures smooth operation without manual intervention every time you
 - On hook (depressed)
   - Nothing happens
 - Off hook (released)
-  - Plays back your own welcome message located in `/sounds/voicemail.wav` followed by the beep indicating ready to record.
+  - Plays back your own added welcome message located in `/sounds/voicemail.wav` followed by the [beep](/sounds/beep.wav) indicating the start of recording.
   - Begins recording the guests voice message.
   - Guest hangs up, recording is stopped and stored to the `/recordings/` directory.
+  - If the guest exceeds the **recording_limit** specified in the [config.yaml](/config.yaml), play the warning [time_exceeded.wav](/sounds/time_exceeded.wav) sound and stop recording.
 
 ### Operation Mode 2: [audioGuestBookwithRotaryDialer](./todo/audioGuestBookwithRotaryDialer.py)
 
diff --git a/audioInterface.py b/audioInterface.py
index bf0ae83..0155f8b 100644
--- a/audioInterface.py
+++ b/audioInterface.py
@@ -66,6 +66,8 @@ class AudioInterface:
                     data = self.stream.read(self.chunk, exception_on_overflow=True)
                     self.frames.append(data)
                 else:
+                    # Notify the user that their recording time is up
+                    self.play("time_exceeded.wav")
                     break
         except KeyboardInterrupt:
             logger.info("Done recording")
@@ -110,14 +112,14 @@ class AudioInterface:
         except OSError as e:
             logger.error(f"Error writing to file {output_file}. Error: {e}")
 
-    def postProcess(self, outputFile):
-        source = AudioSegment.from_wav(outputFile + ".wav")
+    def post_process(self, output_file):
+        source = AudioSegment.from_wav(output_file + ".wav")
         filtered = self.filter_audio(source)
         normalized = self.normalize_audio(filtered)
         compressed = self.compress_audio(normalized)
 
-        normalized.export(outputFile + "normalized.wav", format="wav")
-        compressed.export(outputFile + "compressed.mp3", format="mp3")
+        normalized.export(output_file + "normalized.wav", format="wav")
+        compressed.export(output_file + "compressed.mp3", format="mp3")
 
     def filter_audio(self, audio):
         logger.info("Filtering...")
diff --git a/config.yaml b/config.yaml
index 6877949..493bcd1 100644
--- a/config.yaml
+++ b/config.yaml
@@ -4,7 +4,7 @@ buffer_size: 4096
 channels: 2
 hook_gpio: 22
 playback_reduction: 16
-recording_limit: 60
+recording_limit: 300
 rotary_gpio: 23
 rotary_hold_repeat: true
 rotary_hold_time: 0.25
diff --git a/installer.sh b/installer.sh
index 4b2d3da..9b4fef0 100644
--- a/installer.sh
+++ b/installer.sh
@@ -29,6 +29,103 @@ if ! sudo chown -R $USER:$USER "$DIR"; then
     exit 1
 fi
 
+# Prompt user for config values
+echo "Please provide your configuration values:"
+
+while true; do
+    read -p "alsa_hw_mapping (default 1): " alsa_hw_mapping
+    alsa_hw_mapping=${alsa_hw_mapping:-1}
+    if [[ "$alsa_hw_mapping" =~ ^[0-9]+$ ]]; then
+        break
+    else
+        echo "Invalid number. Please enter a non-negative integer for alsa_hw_mapping."
+    fi
+done
+
+while true; do
+    read -p "number of microphone channels (default 2): " channels
+    channels=${channels:-2}
+    if [[ "$channels" =~ ^[1-9][0-9]*$ ]]; then
+        break
+    else
+        echo "Invalid number. Please enter a positive integer for channels."
+    fi
+done
+
+while true; do
+    read -p "recording sample rate (default 44100): " sample_rate
+    sample_rate=${sample_rate:-44100}
+    if [[ "$sample_rate" =~ ^[89][0-9]{3}$|^[1-9][0-9]{4}$|^[1][0-8][0-9]{4}$|192000$ ]]; then
+        break
+    else
+        echo "Invalid sample rate. Please enter a value between 8000 and 192000."
+    fi
+done
+
+while true; do
+    read -p "recording format - INT16, INT32, FLOAT32 (default INT16): " format
+    format=${format:-INT16}
+    if [[ "$format" =~ ^(INT16|INT32|FLOAT32)$ ]]; then
+        break
+    else
+        echo "Invalid format. Please choose from INT16, INT32, or FLOAT32."
+    fi
+done
+
+while true; do
+    read -p "hook type - normally open (NO) or normally closed (default NC): " hook_type
+    hook_type=${hook_type:-NC}
+    if [[ "$hook_type" =~ ^(NO|NC)$ ]]; then
+        break
+    else
+        echo "Invalid hook type. Please enter either NO or NC."
+    fi
+done
+
+while true; do
+    read -p "hook_gpio (default 22): " hook_gpio
+    hook_gpio=${hook_gpio:-22}
+    if [[ "$hook_gpio" =~ ^[0-9]+$ ]]; then
+        break
+    else
+        echo "Invalid GPIO pin number. Please enter a non-negative integer."
+    fi
+done
+
+while true; do
+    read -p "recording_limit - in seconds (default 300): " recording_limit
+    recording_limit=${recording_limit:-300}
+    if [[ "$recording_limit" =~ ^[0-9]+$ ]]; then
+        break
+    else
+        echo "Invalid recording limit. Please enter a non-negative integer for the number of seconds."
+    fi
+done
+
+# Confirm before overwriting
+read -p "This will overwrite the current config.yaml. Are you sure? (Y/N): " overwrite
+if [[ "$overwrite" != "Y" ]]; then
+    echo "Config update aborted."
+    exit 1
+fi
+
+cat <<EOF >"$DIR/config.yaml"
+alsa_hw_mapping: $alsa_hw_mapping
+beep_reduction: 24
+buffer_size: 4096
+channels: $channels
+hook_gpio: $hook_gpio
+playback_reduction: 16
+recording_limit: $recording_limit
+rotary_gpio: 23
+rotary_hold_repeat: true
+rotary_hold_time: 0.25
+sample_rate: $sample_rate
+source_file: audioGuestBook.py
+format: $format
+hook_type: $hook_type
+EOF
+
 # Replace placeholders in the service file and save to temporary location
 if ! sed "s|<path-to-project>|$DIR|g" "$DIR/audioGuestBook.service.template" >/tmp/audioGuestBook.service; then
     echo "sed command failed."
diff --git a/sounds/time_exceeded.wav b/sounds/time_exceeded.wav
new file mode 100644
index 0000000000000000000000000000000000000000..16b76f20dbd1f9041311a4ca9d8998236db37b8b
GIT binary patch
literal 43610
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

literal 0
HcmV?d00001