From dca6ece19253714b90d7f6476430e6ae76f29652 Mon Sep 17 00:00:00 2001
From: dan <dan@42e.org>
Date: Sat, 19 Aug 2023 16:02:29 +0200
Subject: [PATCH] README

---
 README.md | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)

diff --git a/README.md b/README.md
index 71f0bf1..1e0d6c1 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,77 @@
 # radio-z-am
 
+* [Sito web Studio Radio Zeta-AM](http://www.zam-milano.it/radio-zeta-am/)
+
+## Setup studio (hardware)
+
+Mixer analogico, compressore analogico, PC, scheda audio USB, microfoni XLR, sdoppiatore cuffie analogico, cuffie, cassa.
+
+ * Cavo audio esce dal PC entra nel Mixer via cavo jack 3,5 mm
+ * Microfoni entrano nel Mixer via cavo XLR
+ * Sdoppiatore cuffie esce dal Mixer e collega cuffie e casse
+ * Segnale audio missato esce dal Mixer entra nel compressore
+ * Segnale audio missato e compresso entra nella scheda audio via cavi TRS
+ * Scheda audio collegata al PC via USB
+
+## Setup PC (software)
+
+Il PC è un i5 con 8GB di RAM, due monitor e usa solo software libero.
+
+Sistema operativo GNU/Linux [Debian](https://www.debian.org/) e server audio [JACK](https://jackaudio.org/).
+
+Usa anche il server audio
+[Pulse](https://www.freedesktop.org/wiki/Software/PulseAudio/) per ruotare
+l'audio anche di applicativi che non supportano Jack, come ad esempio il
+Browser.
+
+[Mixxx](https://mixxx.org) è un applicativo DJ con due fonti audio e i controlli
+per attivare fonti audio ausiliarie.
+
+[Mumble](https://parla.abbiamoundominio.org/) è un server VoIP a bassa latenza
+per audio-conferenza che usiamo come studio virtuale esterno.
+
+Mixxx e Mumble supportano nativamente Jack.
+
+Jack usa come entrata la scheda audio USB e come uscita la scheda audio interna al PC.
+
+Ruotando l'audio con Jack, il bottone AUX1 su Mixxx gestisce
+l'audio in provenienza dal Browser.
+
+Il bottone MIC2 su Mixxx gestisce l'audio in provenienza da Mumble (apre i
+microfoni dello studio virtuale).
+
+Il setup finale comprende l'avvio dei server audio (Pulse e Jack), la
+configurazione di Mixxx (AUX1, MIC2 da Jack e record/broadcast da scheda audio
+USB) e di Mumble (uscita su MIC2, entrata da scheda audio USB).
+
+Per questo all'avvio uno [script crea sink e sources PA in Jack](jackshit.sh) e
+un altro ripristina i collegamenti usati dai software: [snapshot dei
+collegamenti Jack](jacksnap.xml).
+
+Perché i collegamenti avvengano correttamente, bisogna che i software siano
+attivi e questo script si prende cura di ciò.: [script di avvio](/home/dan/git/unit/radio-z-am/start.sh).
+
+## Registrazione audio
+
+La registrazione avviene tramite Mixxx.
+
+Mixxx riceve il segnale audio dal compressore e registra in MP3.
+
+## Trasmissione audio stream
+
+La trasmissione audio stream avviene tramite Mixxx in MP3 a 128KBit.
+
+Mixxx riceve il segnale audio dal compressore e lo trasmette al server icecast.
+
+Il server icecast si occupa del broadcast [a questo indirizzo](https://radio.abbiamoundominio.org/listen/zetaam/radio.mp3)
+
+## Trasmissione radio-frequenze
+
+La trasmissione radio in Modulazione d'Ampiezza avviene tramite antenna AM in
+frequenza 1359, ascoltabile da una radiolina AM.
+
+## Programmazione
+
+La programmazione in differita avviene tramite server azuracast.
+
+