https://github.com/avilesxd/loudly

Aplicación de escritorio para masterizar tracks musicales. EQ de 4 bandas, control LUFS, auto-master por referencia y exportación WAV/FLAC.
https://github.com/avilesxd/loudly

audio audio-editor audio-processing customtkinter desktop-app equalizer flac gui limiter loudness lufs mastering matchering music-production music-tools pedalboard pyinstaller python wav windows

Last synced: about 13 hours ago
JSON representation

Aplicación de escritorio para masterizar tracks musicales. EQ de 4 bandas, control LUFS, auto-master por referencia y exportación WAV/FLAC.

• Host: GitHub
• URL: https://github.com/avilesxd/loudly
• Owner: avilesxd
• License: mit
• Created: 2026-05-19T05:01:32.000Z (16 days ago)
• Default Branch: main
• Last Pushed: 2026-05-26T22:51:49.000Z (8 days ago)
• Last Synced: 2026-05-26T23:21:49.117Z (8 days ago)
• Topics: audio, audio-editor, audio-processing, customtkinter, desktop-app, equalizer, flac, gui, limiter, loudness, lufs, mastering, matchering, music-production, music-tools, pedalboard, pyinstaller, python, wav, windows
• Language: Python
• Homepage: https://avilesxd.github.io/loudly/
• Size: 427 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# Loudly — Masterizador de Audio



![Loudly](https://raw.githubusercontent.com/avilesxd/loudly/refs/heads/main/web/public/og.png)

[![CI](https://github.com/avilesxd/loudly/actions/workflows/ci.yml/badge.svg)](https://github.com/avilesxd/loudly/actions/workflows/ci.yml)

[![Release](https://github.com/avilesxd/loudly/actions/workflows/release.yml/badge.svg)](https://github.com/avilesxd/loudly/actions/workflows/release.yml)

[![Latest Release](https://img.shields.io/github/v/release/avilesxd/loudly.svg)](https://github.com/avilesxd/loudly/releases/latest)

[![Downloads](https://img.shields.io/github/downloads/avilesxd/loudly/total.svg)](https://github.com/avilesxd/loudly/releases)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/avilesxd/loudly/blob/main/LICENSE)

[![Python 3.13](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/downloads/)

Aplicación de escritorio para masterizar temas musicales. Wizard de 3 pasos: cargá tu track, ajustá EQ y loudness, y aplicá auto-masterización por referencia.



  





> [!WARNING]

> Al ejecutar `Loudly.exe` por primera vez, Windows puede mostrar el mensaje **"Windows protegió tu PC"** porque el ejecutable no tiene firma de código comercial. El archivo es seguro — podés verificar el código fuente en este repositorio.

>

> **Pasos para ejecutarlo:**

> 1. Hacé clic en **"Más información"**

> 2. Luego en **"Ejecutar de todas formas"**

>

> | Paso 1 — Clic en "Más información" | Paso 2 — Clic en "Ejecutar de todas formas" |

> | :---------------------------------: | :------------------------------------------: |

> | ![SmartScreen paso 1](docs/images/smartscreen-warning.png) | ![SmartScreen paso 2](docs/images/smartscreen-run-anyway.png) |

---



| 📂 Paso 1 — Cargar track | 🎚️ Paso 2 — EQ y Limitador | ⚡ Paso 3 — Auto-Master | 🗂️ Batch Processing |

| :-----------------------: | :-------------------------: | :---------------------: | :------------------: |

| ![Paso 1](docs/images/step1-load.png) | ![Paso 2](docs/images/step2-edit.png) | ![Paso 3](docs/images/step3-master.png) | ![Batch](docs/images/batch-window.png) |



## Características

- **EQ de 4 bandas** — Low (80 Hz), Low-Mid (250 Hz), Hi-Mid (2.5 kHz), High (8 kHz)

- **Limitador con control LUFS** — normaliza a estándares de streaming (Spotify −14, YouTube −13, CD −9)

- **Auto-Master por referencia** — iguala automáticamente el EQ, loudness y dinámica de un track de referencia usando [matchering](https://github.com/sergree/matchering)

- **Procesamiento batch** — auto-masteriza múltiples tracks contra una referencia y los exporta automáticamente como `_remastered.wav`

- **Reproductor con toggle Antes/Después** — escuchá la diferencia en tiempo real

- **Análisis comparativo** — muestra LUFS, True Peak y Dinámica antes y después del procesado

- **Exporta a WAV 24-bit o FLAC**

## Formatos soportados

| Entrada               | Salida            |

| --------------------- | ----------------- |

| WAV, MP3, FLAC, AIFF  | WAV 24-bit, FLAC  |

## Instalación (uso)

Descargá el instalador desde [Releases](https://github.com/avilesxd/loudly/releases/latest).

No requiere Python instalado — es un ejecutable standalone para Windows.

## Instalación (desarrollo)

Requiere Python 3.13.

```bash

git clone https://github.com/avilesxd/loudly.git

cd loudly

python -m venv .venv

.venv\Scripts\pip install -r requirements.txt

.venv\Scripts\python main.py

```

## Compilar a .exe

```bash

.venv\Scripts\pyinstaller loudly.spec --clean

```

El ejecutable queda en `dist\Loudly.exe`.

## Tests

```bash

.venv\Scripts\pytest tests/ -v

```

## Arquitectura

```

loudly/

├── main.py              # Punto de entrada

├── app.py               # LoudlyApp — ventana principal, sesión compartida

├── audio/

│   ├── loader.py        # Carga WAV/MP3/FLAC/AIFF → (channels, samples) float32

│   ├── eq.py            # EQ de 4 bandas con pedalboard

│   ├── limiter.py       # Normalización LUFS + true-peak limiter

│   └── automaster.py    # Auto-masterización con matchering

└── ui/

    ├── batch_window.py      # Ventana de procesamiento batch (CTkToplevel)

    ├── steps/

    │   ├── step1_load.py    # Paso 1: carga de archivos

    │   ├── step2_edit.py    # Paso 2: EQ + limiter interactivos

    │   └── step3_master.py  # Paso 3: auto-master + análisis + exportar

    └── components/

        ├── player.py        # Reproductor ANTES/DESPUÉS

        └── waveform.py      # Visualización de forma de onda

```

El estado de la sesión se mantiene en un diccionario `session` en `LoudlyApp` y se comparte por referencia con los tres pasos. Las operaciones de audio se ejecutan en hilos daemon para no bloquear la UI.

### Convención de datos de audio

Todos los arrays internos son `(channels, samples)` en `float32`. Las bibliotecas externas (soundfile, pyloudnorm) usan `(samples, channels)` y se transponen en los puntos de integración.

## Stack

- **UI**: CustomTkinter

- **EQ / Limiter**: [pedalboard](https://github.com/spotify/pedalboard) (Spotify)

- **Auto-Master**: [matchering](https://github.com/sergree/matchering)

- **LUFS**: pyloudnorm

- **Playback**: sounddevice

- **Waveform**: matplotlib (backend TkAgg)

- **MP3**: miniaudio

- **Build**: PyInstaller

## Documentación adicional

- [Guía de usuario](docs/user-guide.md) — cómo usar la aplicación paso a paso

- [Arquitectura](docs/architecture.md) — detalles técnicos del diseño

## Contribuir

¡Las contribuciones son bienvenidas! Leé la [guía de contribución](.github/CONTRIBUTING.md) para empezar.

Si encontrás un bug o tenés una idea, abrí un [issue](https://github.com/avilesxd/loudly/issues/new/choose).

## Licencia

Distribuido bajo la licencia MIT. Ver [LICENSE](LICENSE) para más información.

---



_Hecho con ❤️ por [Ignacio Avilés](www.linkedin.com/in/ignacioavilescardenasso)_