a

Author: RaspberryPiFpcHub

CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 
 All notable changes to this project are documented in this file.
+
+## [1.0.2] – 2025-08-13
+### Added
+ - A separate settings form is now available.  
+ - If the `Hide` checkbox is enabled, the application window will remain permanently hidden once audio starts playing.
+
 ## [1.0.1] – 2025-07-27
 ### Added
  - A binary has been added to /bin for quick and simple testing.

README.md

@@ -4,9 +4,13 @@ This program receives stereo audio data over UDP (e.g., RTP stream) and outputs
 
 The program automatically detects whether packets are being received:
 - If packets arrive → Audio is played.
-- If no audio packets or only silent ones are received for 5 seconds → Audio output stops, window is hidden.
+- If no audio packets or only silent ones are received for 5 seconds → Audio output stops.
 - For maximum quality, no codec is used – the audio is transmitted uncompressed.
 - This allows for very low latency, making it ideal for real-time transmissions (e.g., monitoring, live audio).
+- A separate settings form is now available.  
+- The application window is now always visible.
+- If the `Hide` checkbox is enabled the application is minimized at startup.
+- A startup file for an FFmpeg audio sender (`StartFFmpegTransmitter.sh`) is provided; when placed on the desktop, it can be started with a double-click.
 
 ---
 
@@ -17,6 +21,19 @@ The program automatically detects whether packets are being received:
 - ALSA installed
 - Network connection for receiving UDP packets
 
+---
+
+## 🧪 Test Setup
+
+The example test setup for development and verification was as follows:
+
+- **Sender**: Raspberry Pi 4 playing YouTube videos in a browser, connected via **2.4 GHz Wi-Fi** to a router.
+- **Receiver**: Another Raspberry Pi 4, connected via **Ethernet (LAN)** to the same router.
+- The receiver’s **3.5 mm Jack audio output** was connected to a **HiFi receiver** for playback.
+
+This setup demonstrated stable low-latency streaming under typical home network conditions.
+
+---
 
 ## ▶️ Usage
 
@@ -29,31 +46,39 @@ If not yet installed, install `ffmpeg`:
 sudo apt install ffmpeg
 ```
 
-To transmit system audio, start the sender with the following command:
-```bash
-ffmpeg -f pulse -i default \
-       -acodec copy -f rtp \
-       -fflags nobuffer -flags low_delay \
-       -max_delay 0 -flush_packets 1 \
-       -rtbufsize 0 -avioflags direct \
-       -reconnect 1 -reconnect_streamed 1 -reconnect_delay_max 1 \
-       rtp://192.168.1.1:5010
-```
+To transmit system audio use the provided startup file `StartFFmpegTransmitter.sh`.
 
-- `192.168.1.1` is the IP address of the receiver → adjust accordingly!
-- `5010` is the port number → freely selectable, must match the receiver
+- IP address of the receiver → replace with the correct address of your receiver.
+- Port → can be freely selected, but must match the receiver’s configuration.
+- If the file is placed on the desktop, the sender can be started by simply double-clicking the file.
+
+---
 
 ### 📥 Receiver
 
 Simply start the receiver:
 ```bash
 ./udp_player
 ```
-
 A window will appear and automatically start playing audio when UDP packets are received.
 
 ---
 
+## 🎯 Optimization Notes
+
+The audio latency is a **parameter of the receiver application** and can be set in its configuration.  
+
+- **Lower latency values** → reduce the audio delay, improving real-time performance.  
+- **Too low values** → may cause **sporadic audio dropouts**, depending on the connection type (Wi-Fi or LAN) and network stability.  
+- **Extremely low values** → may result in **distorted / crackling audio** due to buffer underruns.  
+
+The optimal setting depends on:
+- Network quality and stability.
+- Connection type (LAN generally allows lower latency than Wi-Fi).
+- Performance of the Raspberry Pi and audio output hardware.
+
+---
+
 ## 🔊 If the audio is too quiet …
 
 This may occur if the receiver volume is set too low.
@@ -65,7 +90,9 @@ This may occur if the receiver volume is set too low.
   amixer set 'Master' 100% unmute
   ```
 
+---
+
 ## 📝 License
 
 This project is licensed under the MIT License.
-
+ 

bin/StartFFmpegTransmitter.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+IP_Address_Receiver="192.168.192.123"
+Port=5010
+
+lxterminal -e /usr/bin/ffmpeg -f pulse -i default -acodec copy \
+-f rtp -fflags nobuffer -flags low_delay -max_delay 0 \
+-flush_packets 1 \
+rtp://$IP_Address_Receiver:$Port

bin/udp_player

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+IP_Address_Receiver="192.168.192.123"
+Port=5010
+
+lxterminal -e /usr/bin/ffmpeg -f pulse -i default -acodec copy \
+-f rtp -fflags nobuffer -flags low_delay -max_delay 0 \
+-flush_packets 1 \
+rtp://$IP_Address_Receiver:$Port

source/StartFFmpegTransmitter.sh

@@ -1,6 +1,14 @@
+[network]
 ip=0.0.0.0
 port=5010
-SizeNetworkbuffer=100000
-frequenz=48000
-swap=0
-alsalatency=28000
+buffersize=64000
+
+[audio]
+frequency=48000
+swap byte=0
+
+[alsa]
+latency=20000
+
+[visible]
+hide=1

source/adjust.bmp

@@ -42,6 +42,15 @@
         <HasResources Value="True"/>
         <ResourceBaseClass Value="Form"/>
       </Unit>
+      <Unit>
+        <Filename Value="unit2.pas"/>
+        <FRMtype Value="0"/>
+        <IsPartOfProject Value="True"/>
+        <ComponentName Value="Form2"/>
+        <HasResources Value="True"/>
+        <ResourceBaseClass Value="Form"/>
+        <UnitName Value="Unit2"/>
+      </Unit>
     </Units>
   </ProjectOptions>
   <CompilerOptions>