evo8-linux 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. evo8_linux-0.1.0/LICENSE +21 -0
  2. evo8_linux-0.1.0/PKG-INFO +198 -0
  3. evo8_linux-0.1.0/README.md +181 -0
  4. evo8_linux-0.1.0/pyproject.toml +37 -0
  5. evo8_linux-0.1.0/setup.cfg +4 -0
  6. evo8_linux-0.1.0/src/evo8/__init__.py +3 -0
  7. evo8_linux-0.1.0/src/evo8/about.py +131 -0
  8. evo8_linux-0.1.0/src/evo8/alsa.py +77 -0
  9. evo8_linux-0.1.0/src/evo8/apps.py +76 -0
  10. evo8_linux-0.1.0/src/evo8/calibrate.py +159 -0
  11. evo8_linux-0.1.0/src/evo8/cli.py +214 -0
  12. evo8_linux-0.1.0/src/evo8/data/__init__.py +0 -0
  13. evo8_linux-0.1.0/src/evo8/data/applications/evo8-mixer.desktop +8 -0
  14. evo8_linux-0.1.0/src/evo8/data/evo8-mixer.svg +38 -0
  15. evo8_linux-0.1.0/src/evo8/data/pipewire/pipewire-pulse.conf.d/20-bloquear-volumen-micro.conf +16 -0
  16. evo8_linux-0.1.0/src/evo8/data/pipewire/pipewire.conf.d/20-mezcla.conf +158 -0
  17. evo8_linux-0.1.0/src/evo8/data/systemd/evo8-restore.service +8 -0
  18. evo8_linux-0.1.0/src/evo8/data/udev/70-audient-evo8.rules +7 -0
  19. evo8_linux-0.1.0/src/evo8/gui/__init__.py +1 -0
  20. evo8_linux-0.1.0/src/evo8/gui/app.py +92 -0
  21. evo8_linux-0.1.0/src/evo8/gui/backend.py +485 -0
  22. evo8_linux-0.1.0/src/evo8/gui/meters.py +86 -0
  23. evo8_linux-0.1.0/src/evo8/gui/qml/AboutPage.qml +257 -0
  24. evo8_linux-0.1.0/src/evo8/gui/qml/CardProfiles.qml +118 -0
  25. evo8_linux-0.1.0/src/evo8/gui/qml/ConsolePage.qml +255 -0
  26. evo8_linux-0.1.0/src/evo8/gui/qml/Divider.qml +8 -0
  27. evo8_linux-0.1.0/src/evo8/gui/qml/GlyphButton.qml +30 -0
  28. evo8_linux-0.1.0/src/evo8/gui/qml/HardwarePage.qml +603 -0
  29. evo8_linux-0.1.0/src/evo8/gui/qml/HwMixStrip.qml +178 -0
  30. evo8_linux-0.1.0/src/evo8/gui/qml/Main.qml +139 -0
  31. evo8_linux-0.1.0/src/evo8/gui/qml/PixelSlider.qml +80 -0
  32. evo8_linux-0.1.0/src/evo8/gui/qml/Strip.qml +396 -0
  33. evo8_linux-0.1.0/src/evo8/gui/qml/StripGroup.qml +23 -0
  34. evo8_linux-0.1.0/src/evo8/gui/qml/Theme.qml +22 -0
  35. evo8_linux-0.1.0/src/evo8/gui/qml/Tip.qml +20 -0
  36. evo8_linux-0.1.0/src/evo8/gui/qml/Toggle.qml +41 -0
  37. evo8_linux-0.1.0/src/evo8/gui/qml/VMeter.qml +28 -0
  38. evo8_linux-0.1.0/src/evo8/gui/qml/format.js +88 -0
  39. evo8_linux-0.1.0/src/evo8/gui/qml/qmldir +14 -0
  40. evo8_linux-0.1.0/src/evo8/gui/snapshot.py +98 -0
  41. evo8_linux-0.1.0/src/evo8/hw.py +147 -0
  42. evo8_linux-0.1.0/src/evo8/mix.py +109 -0
  43. evo8_linux-0.1.0/src/evo8/monitor.py +229 -0
  44. evo8_linux-0.1.0/src/evo8/profiles.py +112 -0
  45. evo8_linux-0.1.0/src/evo8/pw.py +164 -0
  46. evo8_linux-0.1.0/src/evo8/state.py +45 -0
  47. evo8_linux-0.1.0/src/evo8/usb.py +122 -0
  48. evo8_linux-0.1.0/src/evo8/user_setup.py +224 -0
  49. evo8_linux-0.1.0/src/evo8_linux.egg-info/PKG-INFO +198 -0
  50. evo8_linux-0.1.0/src/evo8_linux.egg-info/SOURCES.txt +58 -0
  51. evo8_linux-0.1.0/src/evo8_linux.egg-info/dependency_links.txt +1 -0
  52. evo8_linux-0.1.0/src/evo8_linux.egg-info/entry_points.txt +5 -0
  53. evo8_linux-0.1.0/src/evo8_linux.egg-info/requires.txt +6 -0
  54. evo8_linux-0.1.0/src/evo8_linux.egg-info/top_level.txt +1 -0
  55. evo8_linux-0.1.0/tests/test_about.py +51 -0
  56. evo8_linux-0.1.0/tests/test_core.py +124 -0
  57. evo8_linux-0.1.0/tests/test_format_js.py +35 -0
  58. evo8_linux-0.1.0/tests/test_gui.py +92 -0
  59. evo8_linux-0.1.0/tests/test_user_setup.py +72 -0
  60. evo8_linux-0.1.0/tests/test_window.py +54 -0
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 wh01s17
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,198 @@
1
+ Metadata-Version: 2.4
2
+ Name: evo8-linux
3
+ Version: 0.1.0
4
+ Summary: Control del Audient EVO 8 en Linux: mezcla de monitoreo, loop-back, micrófono virtual para llamadas y mezclador.
5
+ Author: wh01s17
6
+ License-Expression: MIT
7
+ Project-URL: Repository, https://github.com/wh01s17/evo8-linux
8
+ Project-URL: Issues, https://github.com/wh01s17/evo8-linux/issues
9
+ Requires-Python: >=3.11
10
+ Description-Content-Type: text/markdown
11
+ License-File: LICENSE
12
+ Provides-Extra: usb
13
+ Requires-Dist: pyusb>=1.2; extra == "usb"
14
+ Provides-Extra: gui
15
+ Requires-Dist: PySide6>=6.6; extra == "gui"
16
+ Dynamic: license-file
17
+
18
+ <p align="center"><img src="https://raw.githubusercontent.com/wh01s17/evo8-linux/main/src/evo8/data/evo8-mixer.svg" width="112" alt="Logo de evo8-linux: un 8 en píxeles con los colores de un medidor de nivel"></p>
19
+
20
+ # evo8-linux
21
+
22
+ Control del **Audient EVO 8** en Linux, más un micrófono virtual pensado para
23
+ tocar y enseñar en videollamadas.
24
+
25
+ Audient solo publica **EVO Control** para Windows y macOS. En Linux la EVO 8
26
+ funciona como interfaz de audio estándar (UAC2), pero el kernel no expone su
27
+ mezcla de monitoreo interna ni el ruteo del loop-back. Este proyecto los
28
+ recupera hablando con la interfaz por USB con el mismo protocolo que usa EVO
29
+ Control, obtenido por ingeniería inversa de la app oficial
30
+ ([`docs/protocolo-usb.md`](https://github.com/wh01s17/evo8-linux/blob/main/docs/protocolo-usb.md)), y suma herramientas para
31
+ PipeWire.
32
+
33
+ > Estado: en desarrollo. Funcionan el CLI `evoctl` y la ventana `evo8-mixer`.
34
+ > Ver [`plan.md`](https://github.com/wh01s17/evo8-linux/blob/main/plan.md).
35
+
36
+ ## Qué hace
37
+
38
+ **Hardware de la EVO 8 (por USB)**
39
+
40
+ - **Loop-back**: elegir qué llega a los canales de captura 5-6. Puede ser el
41
+ par loop-back de fábrica, lo que suena por las salidas 1-2 (todo el audio del
42
+ PC), las salidas 3-4 o las entradas 1-2 / 3-4.
43
+ - **Mezcla de monitoreo interna**: la matriz de 10 entradas (4 analógicas + 6
44
+ del PC) × 4 salidas que EVO Control muestra como MASTER / ARTIST MIX, en dB.
45
+ - **Entradas**: ganancia del preamp en dB, phantom 48 V y silencio.
46
+ - **Al conectarla**: la EVO olvida preamps, mezcla interna y loop-back al
47
+ apagarse; un servicio de usuario los restaura (el phantom no, por
48
+ seguridad).
49
+
50
+ **Micrófono virtual para videollamadas (PipeWire)**
51
+
52
+ - **Mezcla**: una fuente que suma las entradas 1-2 de la EVO y una salida
53
+ virtual **Compartido**. Lo que mandes a Compartido (YouTube, un metrónomo, un
54
+ backing track) lo escuchas tú y también entra a la llamada.
55
+ - Ganancias en vivo por canal, y apps que se mandan a Compartido de a una.
56
+ - **Monitor**: escuchar la Mezcla completa, o una entrada sola, por la salida
57
+ seleccionada, con latencia baja.
58
+ - **Sincronía**: quien toca encima de la música la oye con la latencia de
59
+ salida, y su instrumento vuelve con la de entrada. `evoctl calibrate` mide ese
60
+ desfase con un click y lo compensa retrasando la música solo hacia la Mezcla.
61
+ - Evita que el navegador (Meet, Zoom web) baje el volumen del micrófono por su
62
+ cuenta.
63
+
64
+ ## Instalación
65
+
66
+ Solo para la **Audient EVO 8** (no la EVO 4 ni la EVO 16). El control por USB
67
+ se probó con el firmware 1.4c.
68
+
69
+ ### Arch Linux (paquete)
70
+
71
+ ```sh
72
+ git clone https://github.com/wh01s17/evo8-linux
73
+ cd evo8-linux/packaging/arch
74
+ makepkg -si
75
+ systemctl --user restart pipewire pipewire-pulse wireplumber
76
+ ```
77
+
78
+ Instala `evoctl` y `evo8-mixer` en `/usr/bin`, la config de PipeWire en
79
+ `/usr/share/pipewire`, la regla udev y el servicio que restaura los ajustes al
80
+ conectar la EVO (desconéctala y vuelve a conectarla una vez). Arrastra las
81
+ dependencias, incluida la fuente *JetBrainsMono Nerd Font* de los íconos.
82
+
83
+ ### Otras distribuciones (pip / pipx)
84
+
85
+ ```sh
86
+ pipx install "evo8-linux[gui,usb]"
87
+ evoctl setup # config de PipeWire, servicio y menú en tu usuario; dice qué falta
88
+ ```
89
+
90
+ pip solo instala Python: `evoctl setup` copia a tu carpeta de usuario la config
91
+ de PipeWire, el servicio que restaura los ajustes y la entrada del menú, y te
92
+ da el comando `sudo` exacto para la regla udev (control por USB sin root).
93
+ También avisa si faltan PipeWire, WirePlumber, `pactl`, `amixer` o la fuente de
94
+ los íconos. Después de actualizar con `pipx upgrade`, vuelve a correr
95
+ `evoctl setup`. Para desinstalar: `evoctl setup --remove` y
96
+ `pipx uninstall evo8-linux`.
97
+
98
+ ### Desde el código (desarrollo)
99
+
100
+ Requisitos: PipeWire + WirePlumber, `pactl`, `amixer`, Python ≥ 3.11,
101
+ `python-pyusb` para el control por USB, `pyside6` y `qt6-svg` para la ventana y
102
+ *JetBrainsMono Nerd Font* (`ttf-jetbrains-mono-nerd`) para los íconos.
103
+
104
+ ```sh
105
+ git clone https://github.com/wh01s17/evo8-linux
106
+ cd evo8-linux
107
+ make install # evoctl y evo8-mixer en ~/.local/bin (apuntan a esta carpeta), la config de PipeWire en ~/.config
108
+ sudo make udev # permite al usuario hablar con la EVO por USB sin root
109
+ systemctl --user restart pipewire pipewire-pulse wireplumber
110
+ ```
111
+
112
+ No mezcles las dos: con el paquete instalado, `make uninstall` quita los
113
+ lanzadores de `~/.local/bin`, que si no tendrían prioridad sobre los de `/usr/bin`.
114
+
115
+ La EVO 8 tiene que estar en el perfil **Pro Audio**
116
+ (`evoctl profiles set alsa_card.usb-Audient_EVO8-00 pro-audio`). En Meet, elige
117
+ **Mezcla** como micrófono y desactiva la cancelación de ruido.
118
+
119
+ ## Uso
120
+
121
+ ### Ventana
122
+
123
+ `evo8-mixer` abre el mezclador. Tiene tres pestañas:
124
+
125
+ - **CONSOLA**: una tira por canal (entradas, Compartido, apps, la Mezcla y la
126
+ salida) con preamp, fader, medidores, compartir, silencio, sincronía, monitor
127
+ y 󰑐 para volver al valor estándar. Al final, los perfiles
128
+ de cada tarjeta (cómo la usa el sistema), con lo que hace cada uno.
129
+ En la tira de Compartido, *Calibrar* mide el desfase mientras tocas sobre
130
+ un click y ajusta la sincronía.
131
+ - **EVO 8**: el loop-back y la mezcla de monitoreo interna. Los cambios quedan
132
+ en espera hasta que pulsas *Aplicar a la EVO*.
133
+ - **ACERCA DE**: versión, enlaces al repo y a los issues, el firmware de la EVO
134
+ conectada y cómo está instalado. *Copiar para reportar un problema* deja esos
135
+ datos en el portapapeles (con `~` en lugar de tu carpeta personal).
136
+
137
+ `evo8-mixer --evo` abre directo en la pestaña EVO 8. Hay una sola ventana: volver a
138
+ lanzar `evo8-mixer` la trae al frente (y abre otra si la anterior dejó de
139
+ responder).
140
+
141
+ ### CLI
142
+
143
+ ```sh
144
+ # Mezcla (micrófono virtual)
145
+ evoctl mix get # ganancias: [entrada 1, entrada 2, Compartido L, R]
146
+ evoctl mix set 1 0.8 # entrada 1 al 80 % (lineal, 0..4)
147
+ evoctl share list # apps que están en Compartido
148
+ evoctl share on <node-id> # mandar una app a Compartido
149
+ evoctl delay set 40 # retrasar Compartido 40 ms hacia la Mezcla
150
+ evoctl calibrate --apply # medir el desfase tocando sobre un click
151
+ evoctl apply # restaurar lo guardado tras reiniciar PipeWire
152
+
153
+ # Monitor
154
+ evoctl monitor toggle # escuchar la Mezcla completa
155
+ evoctl monitor input 1 on # escuchar solo la entrada 1
156
+
157
+ # Hardware de la EVO
158
+ evoctl preamp set 2 24.5 # preamp de la entrada 2 en dB
159
+ evoctl hw input phantom 2 on # 48 V en la entrada 2
160
+ evoctl hw input mute 3 on # silenciar la entrada 3 en la EVO
161
+ evoctl hw loopback set pc12 # loop-back = lo que suena por las salidas 1-2
162
+ evoctl hw mix get # mezcla interna (dB)
163
+ evoctl hw mix set 1 1 -6 # entrada 1 → salida 1 a -6 dB
164
+ evoctl hw mix set 5 3 off # PC 1 → salida 3 apagado
165
+ ```
166
+
167
+ Los comandos `hw` sueltan por un instante el driver de audio del kernel para
168
+ enviar la orden y lo devuelven de inmediato. El audio se corta ~0,1 s. Úsalos
169
+ para configurar, no durante una llamada.
170
+
171
+ ## Cómo funciona
172
+
173
+ ```
174
+ EVO entradas 1-2 ─► mezcla.entradas ─┐
175
+ ├─► mezcla.suma (filter-chain: delay + ganancias) ─► Mezcla
176
+ Apps ─► Compartido ─┬─► mezcla.compartido ┘
177
+ └─► mezcla.compartido.escucha ─► salida seleccionada
178
+ ```
179
+
180
+ - [`src/evo8/`](https://github.com/wh01s17/evo8-linux/tree/main/src/evo8): librería y CLI. `pw.py` (herramientas de PipeWire),
181
+ `mix.py`, `monitor.py`, `calibrate.py`, `apps.py`, `alsa.py`, `usb.py`
182
+ (transporte UAC2) y `hw.py` (loop-back y mezcla interna).
183
+ - [`src/evo8/data/pipewire/`](https://github.com/wh01s17/evo8-linux/tree/main/src/evo8/data/pipewire): el grafo de la Mezcla.
184
+ - [`docs/protocolo-usb.md`](https://github.com/wh01s17/evo8-linux/blob/main/docs/protocolo-usb.md): topología USB de la EVO 8,
185
+ las peticiones que usa EVO Control y lo verificado en el dispositivo.
186
+ - [`plan.md`](https://github.com/wh01s17/evo8-linux/blob/main/plan.md): arquitectura, estado y próximos pasos.
187
+
188
+ ## Advertencia
189
+
190
+ Proyecto independiente, sin relación con Audient. El control por USB se basa
191
+ en ingeniería inversa para interoperabilidad. Se probó en una EVO 8 con
192
+ firmware 1.4c. Úsalo bajo tu responsabilidad: si la interfaz deja de
193
+ responder, desconéctala y vuelve a conectarla. No incluye código ni binarios
194
+ de Audient.
195
+
196
+ ## Licencia
197
+
198
+ MIT
@@ -0,0 +1,181 @@
1
+ <p align="center"><img src="https://raw.githubusercontent.com/wh01s17/evo8-linux/main/src/evo8/data/evo8-mixer.svg" width="112" alt="Logo de evo8-linux: un 8 en píxeles con los colores de un medidor de nivel"></p>
2
+
3
+ # evo8-linux
4
+
5
+ Control del **Audient EVO 8** en Linux, más un micrófono virtual pensado para
6
+ tocar y enseñar en videollamadas.
7
+
8
+ Audient solo publica **EVO Control** para Windows y macOS. En Linux la EVO 8
9
+ funciona como interfaz de audio estándar (UAC2), pero el kernel no expone su
10
+ mezcla de monitoreo interna ni el ruteo del loop-back. Este proyecto los
11
+ recupera hablando con la interfaz por USB con el mismo protocolo que usa EVO
12
+ Control, obtenido por ingeniería inversa de la app oficial
13
+ ([`docs/protocolo-usb.md`](https://github.com/wh01s17/evo8-linux/blob/main/docs/protocolo-usb.md)), y suma herramientas para
14
+ PipeWire.
15
+
16
+ > Estado: en desarrollo. Funcionan el CLI `evoctl` y la ventana `evo8-mixer`.
17
+ > Ver [`plan.md`](https://github.com/wh01s17/evo8-linux/blob/main/plan.md).
18
+
19
+ ## Qué hace
20
+
21
+ **Hardware de la EVO 8 (por USB)**
22
+
23
+ - **Loop-back**: elegir qué llega a los canales de captura 5-6. Puede ser el
24
+ par loop-back de fábrica, lo que suena por las salidas 1-2 (todo el audio del
25
+ PC), las salidas 3-4 o las entradas 1-2 / 3-4.
26
+ - **Mezcla de monitoreo interna**: la matriz de 10 entradas (4 analógicas + 6
27
+ del PC) × 4 salidas que EVO Control muestra como MASTER / ARTIST MIX, en dB.
28
+ - **Entradas**: ganancia del preamp en dB, phantom 48 V y silencio.
29
+ - **Al conectarla**: la EVO olvida preamps, mezcla interna y loop-back al
30
+ apagarse; un servicio de usuario los restaura (el phantom no, por
31
+ seguridad).
32
+
33
+ **Micrófono virtual para videollamadas (PipeWire)**
34
+
35
+ - **Mezcla**: una fuente que suma las entradas 1-2 de la EVO y una salida
36
+ virtual **Compartido**. Lo que mandes a Compartido (YouTube, un metrónomo, un
37
+ backing track) lo escuchas tú y también entra a la llamada.
38
+ - Ganancias en vivo por canal, y apps que se mandan a Compartido de a una.
39
+ - **Monitor**: escuchar la Mezcla completa, o una entrada sola, por la salida
40
+ seleccionada, con latencia baja.
41
+ - **Sincronía**: quien toca encima de la música la oye con la latencia de
42
+ salida, y su instrumento vuelve con la de entrada. `evoctl calibrate` mide ese
43
+ desfase con un click y lo compensa retrasando la música solo hacia la Mezcla.
44
+ - Evita que el navegador (Meet, Zoom web) baje el volumen del micrófono por su
45
+ cuenta.
46
+
47
+ ## Instalación
48
+
49
+ Solo para la **Audient EVO 8** (no la EVO 4 ni la EVO 16). El control por USB
50
+ se probó con el firmware 1.4c.
51
+
52
+ ### Arch Linux (paquete)
53
+
54
+ ```sh
55
+ git clone https://github.com/wh01s17/evo8-linux
56
+ cd evo8-linux/packaging/arch
57
+ makepkg -si
58
+ systemctl --user restart pipewire pipewire-pulse wireplumber
59
+ ```
60
+
61
+ Instala `evoctl` y `evo8-mixer` en `/usr/bin`, la config de PipeWire en
62
+ `/usr/share/pipewire`, la regla udev y el servicio que restaura los ajustes al
63
+ conectar la EVO (desconéctala y vuelve a conectarla una vez). Arrastra las
64
+ dependencias, incluida la fuente *JetBrainsMono Nerd Font* de los íconos.
65
+
66
+ ### Otras distribuciones (pip / pipx)
67
+
68
+ ```sh
69
+ pipx install "evo8-linux[gui,usb]"
70
+ evoctl setup # config de PipeWire, servicio y menú en tu usuario; dice qué falta
71
+ ```
72
+
73
+ pip solo instala Python: `evoctl setup` copia a tu carpeta de usuario la config
74
+ de PipeWire, el servicio que restaura los ajustes y la entrada del menú, y te
75
+ da el comando `sudo` exacto para la regla udev (control por USB sin root).
76
+ También avisa si faltan PipeWire, WirePlumber, `pactl`, `amixer` o la fuente de
77
+ los íconos. Después de actualizar con `pipx upgrade`, vuelve a correr
78
+ `evoctl setup`. Para desinstalar: `evoctl setup --remove` y
79
+ `pipx uninstall evo8-linux`.
80
+
81
+ ### Desde el código (desarrollo)
82
+
83
+ Requisitos: PipeWire + WirePlumber, `pactl`, `amixer`, Python ≥ 3.11,
84
+ `python-pyusb` para el control por USB, `pyside6` y `qt6-svg` para la ventana y
85
+ *JetBrainsMono Nerd Font* (`ttf-jetbrains-mono-nerd`) para los íconos.
86
+
87
+ ```sh
88
+ git clone https://github.com/wh01s17/evo8-linux
89
+ cd evo8-linux
90
+ make install # evoctl y evo8-mixer en ~/.local/bin (apuntan a esta carpeta), la config de PipeWire en ~/.config
91
+ sudo make udev # permite al usuario hablar con la EVO por USB sin root
92
+ systemctl --user restart pipewire pipewire-pulse wireplumber
93
+ ```
94
+
95
+ No mezcles las dos: con el paquete instalado, `make uninstall` quita los
96
+ lanzadores de `~/.local/bin`, que si no tendrían prioridad sobre los de `/usr/bin`.
97
+
98
+ La EVO 8 tiene que estar en el perfil **Pro Audio**
99
+ (`evoctl profiles set alsa_card.usb-Audient_EVO8-00 pro-audio`). En Meet, elige
100
+ **Mezcla** como micrófono y desactiva la cancelación de ruido.
101
+
102
+ ## Uso
103
+
104
+ ### Ventana
105
+
106
+ `evo8-mixer` abre el mezclador. Tiene tres pestañas:
107
+
108
+ - **CONSOLA**: una tira por canal (entradas, Compartido, apps, la Mezcla y la
109
+ salida) con preamp, fader, medidores, compartir, silencio, sincronía, monitor
110
+ y 󰑐 para volver al valor estándar. Al final, los perfiles
111
+ de cada tarjeta (cómo la usa el sistema), con lo que hace cada uno.
112
+ En la tira de Compartido, *Calibrar* mide el desfase mientras tocas sobre
113
+ un click y ajusta la sincronía.
114
+ - **EVO 8**: el loop-back y la mezcla de monitoreo interna. Los cambios quedan
115
+ en espera hasta que pulsas *Aplicar a la EVO*.
116
+ - **ACERCA DE**: versión, enlaces al repo y a los issues, el firmware de la EVO
117
+ conectada y cómo está instalado. *Copiar para reportar un problema* deja esos
118
+ datos en el portapapeles (con `~` en lugar de tu carpeta personal).
119
+
120
+ `evo8-mixer --evo` abre directo en la pestaña EVO 8. Hay una sola ventana: volver a
121
+ lanzar `evo8-mixer` la trae al frente (y abre otra si la anterior dejó de
122
+ responder).
123
+
124
+ ### CLI
125
+
126
+ ```sh
127
+ # Mezcla (micrófono virtual)
128
+ evoctl mix get # ganancias: [entrada 1, entrada 2, Compartido L, R]
129
+ evoctl mix set 1 0.8 # entrada 1 al 80 % (lineal, 0..4)
130
+ evoctl share list # apps que están en Compartido
131
+ evoctl share on <node-id> # mandar una app a Compartido
132
+ evoctl delay set 40 # retrasar Compartido 40 ms hacia la Mezcla
133
+ evoctl calibrate --apply # medir el desfase tocando sobre un click
134
+ evoctl apply # restaurar lo guardado tras reiniciar PipeWire
135
+
136
+ # Monitor
137
+ evoctl monitor toggle # escuchar la Mezcla completa
138
+ evoctl monitor input 1 on # escuchar solo la entrada 1
139
+
140
+ # Hardware de la EVO
141
+ evoctl preamp set 2 24.5 # preamp de la entrada 2 en dB
142
+ evoctl hw input phantom 2 on # 48 V en la entrada 2
143
+ evoctl hw input mute 3 on # silenciar la entrada 3 en la EVO
144
+ evoctl hw loopback set pc12 # loop-back = lo que suena por las salidas 1-2
145
+ evoctl hw mix get # mezcla interna (dB)
146
+ evoctl hw mix set 1 1 -6 # entrada 1 → salida 1 a -6 dB
147
+ evoctl hw mix set 5 3 off # PC 1 → salida 3 apagado
148
+ ```
149
+
150
+ Los comandos `hw` sueltan por un instante el driver de audio del kernel para
151
+ enviar la orden y lo devuelven de inmediato. El audio se corta ~0,1 s. Úsalos
152
+ para configurar, no durante una llamada.
153
+
154
+ ## Cómo funciona
155
+
156
+ ```
157
+ EVO entradas 1-2 ─► mezcla.entradas ─┐
158
+ ├─► mezcla.suma (filter-chain: delay + ganancias) ─► Mezcla
159
+ Apps ─► Compartido ─┬─► mezcla.compartido ┘
160
+ └─► mezcla.compartido.escucha ─► salida seleccionada
161
+ ```
162
+
163
+ - [`src/evo8/`](https://github.com/wh01s17/evo8-linux/tree/main/src/evo8): librería y CLI. `pw.py` (herramientas de PipeWire),
164
+ `mix.py`, `monitor.py`, `calibrate.py`, `apps.py`, `alsa.py`, `usb.py`
165
+ (transporte UAC2) y `hw.py` (loop-back y mezcla interna).
166
+ - [`src/evo8/data/pipewire/`](https://github.com/wh01s17/evo8-linux/tree/main/src/evo8/data/pipewire): el grafo de la Mezcla.
167
+ - [`docs/protocolo-usb.md`](https://github.com/wh01s17/evo8-linux/blob/main/docs/protocolo-usb.md): topología USB de la EVO 8,
168
+ las peticiones que usa EVO Control y lo verificado en el dispositivo.
169
+ - [`plan.md`](https://github.com/wh01s17/evo8-linux/blob/main/plan.md): arquitectura, estado y próximos pasos.
170
+
171
+ ## Advertencia
172
+
173
+ Proyecto independiente, sin relación con Audient. El control por USB se basa
174
+ en ingeniería inversa para interoperabilidad. Se probó en una EVO 8 con
175
+ firmware 1.4c. Úsalo bajo tu responsabilidad: si la interfaz deja de
176
+ responder, desconéctala y vuelve a conectarla. No incluye código ni binarios
177
+ de Audient.
178
+
179
+ ## Licencia
180
+
181
+ MIT
@@ -0,0 +1,37 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "evo8-linux"
7
+ dynamic = ["version"]
8
+ description = "Control del Audient EVO 8 en Linux: mezcla de monitoreo, loop-back, micrófono virtual para llamadas y mezclador."
9
+ readme = "README.md"
10
+ requires-python = ">=3.11"
11
+ license = "MIT"
12
+ authors = [{ name = "wh01s17" }]
13
+ dependencies = []
14
+
15
+ [project.urls]
16
+ Repository = "https://github.com/wh01s17/evo8-linux"
17
+ Issues = "https://github.com/wh01s17/evo8-linux/issues"
18
+
19
+ [project.optional-dependencies]
20
+ usb = ["pyusb>=1.2"]
21
+ gui = ["PySide6>=6.6"]
22
+
23
+ [project.scripts]
24
+ evoctl = "evo8.cli:main"
25
+
26
+ [project.gui-scripts]
27
+ evo8-mixer = "evo8.gui.app:main"
28
+
29
+ [tool.setuptools.dynamic]
30
+ version = { attr = "evo8.__version__" }
31
+
32
+ [tool.setuptools.packages.find]
33
+ where = ["src"]
34
+
35
+ [tool.setuptools.package-data]
36
+ "evo8.gui" = ["qml/*.qml", "qml/*.js", "qml/qmldir"]
37
+ "evo8.data" = ["*.svg", "**/*.conf", "**/*.rules", "**/*.service", "**/*.desktop"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,3 @@
1
+ """Audient EVO 8 on Linux."""
2
+
3
+ __version__ = "0.1.0"
@@ -0,0 +1,131 @@
1
+ """What the "Acerca de" tab and `evoctl --version` show.
2
+
3
+ Everything here is read from files (package metadata, sysfs, config paths):
4
+ nothing talks to the EVO over USB, so it is safe to call at any time.
5
+ """
6
+
7
+ from __future__ import annotations
8
+
9
+ import os
10
+ import platform
11
+ from pathlib import Path
12
+
13
+ from . import __version__, state
14
+
15
+ NAME = "evo8-linux"
16
+ APP = "Mezclador EVO 8"
17
+ DESCRIPTION = ("Control del Audient EVO 8 en Linux: mezcla de monitoreo interna, "
18
+ "loop-back, preamps y un micrófono virtual para videollamadas.")
19
+ AUTHOR = "wh01s17"
20
+ LICENSE = "MIT"
21
+ REPO = "https://github.com/wh01s17/evo8-linux"
22
+ ISSUES = REPO + "/issues"
23
+ DISCLAIMER = "Proyecto no oficial, sin relación con Audient."
24
+ TESTED_FIRMWARE = "1.4c"
25
+
26
+ VENDOR_ID, PRODUCT_ID = "2708", "0007"
27
+ SYSFS_USB = Path("/sys/bus/usb/devices")
28
+
29
+ _CONFIG_DIRS = (
30
+ ("usuario", Path(os.environ.get("XDG_CONFIG_HOME") or os.path.expanduser("~/.config")) / "pipewire"),
31
+ ("sistema", Path("/etc/pipewire")),
32
+ ("paquete", Path("/usr/share/pipewire")),
33
+ )
34
+ _UDEV_RULES = (Path("/etc/udev/rules.d/70-audient-evo8.rules"),
35
+ Path("/usr/lib/udev/rules.d/70-audient-evo8.rules"))
36
+
37
+
38
+ def tilde(path) -> str:
39
+ """The path with the home folder as "~", so reports don't carry the user name."""
40
+ text, home = str(path), os.path.expanduser("~")
41
+ return "~" + text[len(home):] if home not in ("", "/") and (text == home or text.startswith(home + "/")) else text
42
+
43
+
44
+ def version() -> str:
45
+ try:
46
+ from importlib.metadata import PackageNotFoundError, version as dist_version
47
+ return dist_version(NAME)
48
+ except (ImportError, PackageNotFoundError):
49
+ return __version__
50
+
51
+
52
+ def firmware_text(bcd: str) -> str:
53
+ """bcdDevice as sysfs prints it ("014c") → "1.4c"."""
54
+ bcd = bcd.strip().lower()
55
+ if len(bcd) != 4:
56
+ return bcd
57
+ return f"{int(bcd[:2], 16)}.{bcd[2:]}"
58
+
59
+
60
+ def device(root: Path = SYSFS_USB) -> dict:
61
+ """{connected, firmware, tested, speed} from sysfs, without any USB traffic."""
62
+ try:
63
+ entries = sorted(root.iterdir())
64
+ except OSError:
65
+ entries = []
66
+ for d in entries:
67
+ try:
68
+ if (d / "idVendor").read_text().strip() != VENDOR_ID:
69
+ continue
70
+ if (d / "idProduct").read_text().strip() != PRODUCT_ID:
71
+ continue
72
+ fw = firmware_text((d / "bcdDevice").read_text())
73
+ speed = (d / "speed").read_text().strip() if (d / "speed").exists() else ""
74
+ except OSError:
75
+ continue
76
+ return {"connected": True, "firmware": fw, "tested": fw == TESTED_FIRMWARE,
77
+ "speed": f"{speed} Mbit/s" if speed else ""}
78
+ return {"connected": False, "firmware": "", "tested": False, "speed": ""}
79
+
80
+
81
+ def install_kind(module_file: str = __file__) -> str:
82
+ path = Path(module_file).resolve()
83
+ if (path.parents[2] / ".git").exists():
84
+ return f"desarrollo ({tilde(path.parents[2])})"
85
+ if str(path).startswith("/usr/"):
86
+ return "paquete del sistema"
87
+ return "pip"
88
+
89
+
90
+ def pipewire_config() -> str:
91
+ """Where the Mezcla config PipeWire loads comes from (first one wins)."""
92
+ for label, base in _CONFIG_DIRS:
93
+ f = base / "pipewire.conf.d" / "20-mezcla.conf"
94
+ if f.exists():
95
+ return f"{tilde(f)} ({label})"
96
+ return ""
97
+
98
+
99
+ def udev_rule() -> str:
100
+ return next((str(p) for p in _UDEV_RULES if p.exists()), "")
101
+
102
+
103
+ def info(extra_versions: dict | None = None) -> dict:
104
+ return {
105
+ "name": NAME, "app": APP, "version": version(), "description": DESCRIPTION,
106
+ "author": AUTHOR, "license": LICENSE, "repo": REPO, "issues": ISSUES,
107
+ "disclaimer": DISCLAIMER, "testedFirmware": TESTED_FIRMWARE,
108
+ "device": device(),
109
+ "install": install_kind(),
110
+ "pipewireConfig": pipewire_config(),
111
+ "udevRule": udev_rule(),
112
+ "stateFile": tilde(state.STATE),
113
+ "versions": {"Python": platform.python_version(), **(extra_versions or {})},
114
+ "platform": f"{platform.system()} {platform.release()}",
115
+ }
116
+
117
+
118
+ def report(data: dict | None = None) -> str:
119
+ """Plain text to paste into a bug report."""
120
+ d = data or info()
121
+ dev = d["device"]
122
+ lines = [
123
+ f"{d['name']} {d['version']}",
124
+ f"EVO 8: {'conectada, firmware ' + dev['firmware'] if dev['connected'] else 'no conectada'}",
125
+ f"Instalación: {d['install']}",
126
+ f"Config de PipeWire: {d['pipewireConfig'] or 'no encontrada'}",
127
+ f"Regla udev: {d['udevRule'] or 'no instalada'}",
128
+ f"Sistema: {d['platform']}",
129
+ ]
130
+ lines += [f"{k}: {v}" for k, v in d["versions"].items()]
131
+ return "\n".join(lines)
@@ -0,0 +1,77 @@
1
+ """Controls the kernel driver (snd-usb-audio) already exposes for the EVO 8.
2
+
3
+ "Mic Playback Volume" is the analog preamp gain per input (the same one the
4
+ interface's knob turns), raw 0..116 = -8..+50 dB in 0.5 dB steps. The EVO does
5
+ not keep these across a power cycle (it comes back at -8 dB), so every change
6
+ is saved and `restore_preamp()` puts them back.
7
+ """
8
+
9
+ from __future__ import annotations
10
+
11
+ import os
12
+ import re
13
+
14
+ from . import pw, state
15
+
16
+ CARD = os.environ.get("EVO8_ALSA_CARD", "EVO8")
17
+ PREAMP_CONTROL = "Mic Playback Volume"
18
+
19
+
20
+ class AlsaError(RuntimeError):
21
+ pass
22
+
23
+
24
+ def _control(name: str) -> dict:
25
+ info = pw.run("amixer", "-c", CARD, "cget", f"name={name}")
26
+ if not info:
27
+ raise AlsaError(f"control '{name}' not found on card {CARD}")
28
+ rng = re.search(r"min=(-?\d+),max=(-?\d+)", info)
29
+ db = re.search(r"dBminmax-min=(-?[\d.]+)dB,max=(-?[\d.]+)dB", info)
30
+ vals = re.search(r": values=([\d,-]+)", info)
31
+ if not (rng and db and vals):
32
+ raise AlsaError(f"could not parse '{name}' on card {CARD}")
33
+ return {
34
+ "raw_min": int(rng[1]), "raw_max": int(rng[2]),
35
+ "db_min": float(db[1]), "db_max": float(db[2]),
36
+ "values": [int(v) for v in vals[1].split(",")],
37
+ }
38
+
39
+
40
+ def preamp() -> dict:
41
+ """{"min", "max", "step", "gains"} in dB."""
42
+ c = _control(PREAMP_CONTROL)
43
+ step = (c["db_max"] - c["db_min"]) / (c["raw_max"] - c["raw_min"])
44
+ gains = [round(c["db_min"] + (v - c["raw_min"]) * step, 2) for v in c["values"]]
45
+ return {"min": c["db_min"], "max": c["db_max"], "step": round(step, 4), "gains": gains}
46
+
47
+
48
+ def set_preamp(n: int, db: float) -> None:
49
+ c = _control(PREAMP_CONTROL)
50
+ if not 1 <= n <= len(c["values"]):
51
+ raise AlsaError(f"input must be 1-{len(c['values'])}")
52
+ db = min(max(db, c["db_min"]), c["db_max"])
53
+ raw = round(c["raw_min"] + (db - c["db_min"]) / (c["db_max"] - c["db_min"]) * (c["raw_max"] - c["raw_min"]))
54
+ values = list(c["values"])
55
+ values[n - 1] = raw
56
+ pw.run("amixer", "-c", CARD, "cset", f"name={PREAMP_CONTROL}", ",".join(map(str, values)), check=True)
57
+ applied = c["db_min"] + (raw - c["raw_min"]) * (c["db_max"] - c["db_min"]) / (c["raw_max"] - c["raw_min"])
58
+ saved = state.load().get("preamp") or {}
59
+ saved[str(n)] = round(applied, 2)
60
+ state.save("preamp", saved)
61
+
62
+
63
+ def restore_preamp() -> None:
64
+ saved = state.load().get("preamp") or {}
65
+ try:
66
+ c = _control(PREAMP_CONTROL)
67
+ except AlsaError:
68
+ return
69
+ values = list(c["values"])
70
+ for key, db in saved.items():
71
+ n = int(key)
72
+ if 1 <= n <= len(values) and isinstance(db, (int, float)):
73
+ db = min(max(db, c["db_min"]), c["db_max"])
74
+ values[n - 1] = round(c["raw_min"] + (db - c["db_min"]) / (c["db_max"] - c["db_min"])
75
+ * (c["raw_max"] - c["raw_min"]))
76
+ if values != c["values"]:
77
+ pw.run("amixer", "-c", CARD, "cset", f"name={PREAMP_CONTROL}", ",".join(map(str, values)))