Extiende canciones y genera videos listos para subir โ desde la terminal.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ต toma tu audio โ extiende el loop โ ๐ฌ mp4 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Instalaciรณn ยท Uso ยท Imรกgenes de prueba ยท Acerca de
Este proyecto naciรณ pensando en el trabajo de BrawlBRSTMs3, quien durante aรฑos extendiรณ miles de pistas de videojuegos para YouTube, convirtiendo loops cortos en experiencias musicales interminables.
LoopForge automatiza ese proceso.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ BrawlBRSTMs3 extendiรณ manualmente miles de canciones de juegos โ
โ LoopForge lo hace por ti en segundos, desde la terminal. โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ต cancion.mp3 ๐๏ธ loopforge ๐ฌ cancion.mp4
โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ
โ Audio corto โ โ โ Detecta el โ โ โ Video 1280x720 โ
โ (loop de โ โ loop point โ โ con imagen โ
โ juego) โ โ y lo extiendeโ โ portada โ
โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโดโโโโโโโโโ
โ Listo para โ
โ subir a โ
โ YouTube ๐ โ
โโโโโโโโโโโโโโโโโโโ
| Paso | Descripciรณn |
|---|---|
| โ | Detecta CPU/RAM y ajusta procesamiento paralelo automรกticamente |
| โก | Filtra audios < 15s y elimina duplicados por hash MD5 |
| โข | Extiende cada audio con pymusiclooper (detecciรณn de loop points) |
| โฃ | Preprocesa la imagen de portada (fondo difuminado + cover centrada) |
| โค | Renderiza el video en 1280ร720 con ffmpeg (ultrafast + stillimage) |
| โฅ | Organiza los videos en carpetas โ ยกlisto para YouTube! |
๐ง Arch Linux
sudo pacman -S ffmpeg yt-dlp imagemagick
pip install pymusiclooper
# Extras opcionales:
sudo pacman -S unrar jq๐ฆ Ubuntu / Debian
sudo apt install ffmpeg yt-dlp imagemagick python3-pip
pip install pymusiclooper
# Extras opcionales:
sudo apt install unrar jq๐ macOS
brew install ffmpeg yt-dlp imagemagick
pip install pymusicloopergit clone https://github.com/SrSlocko/loopforge.git
cd loopforge
chmod +x loopforge.sh
./loopforge.sh --help# ๐ต Canciรณn individual
./loopforge.sh cancion.mp3 60 cover.jpg
# ๐ Carpeta completa (procesa en paralelo)
./loopforge.sh ./mi_musica 180 cover.jpg
# ๐ฆ Archivo comprimido
./loopforge.sh album.zip 30 cover.jpg
# ๐ Playlist de YouTube
./loopforge.sh "https://youtube.com/playlist?list=XXXXX" 60
# ๐ Mรบltiples entradas (separadas por coma)
./loopforge.sh a.mp3 60 cover1.jpg , b.mp3 30 cover2.jpg
# ๐งช Modo tester (solo primer archivo)
./loopforge.sh cancion.mp3 60 cover.jpg -tester
# โฐ Apagar el PC al terminar
./loopforge.sh cancion.mp3 60 cover.jpg -shutdown 30| Tipo | Ejemplo | Descripciรณn |
|---|---|---|
| ๐ต Audio | cancion.mp3 |
MP3, WAV, FLAC, OGG, M4A |
| ๐ Carpeta | ./musica/ |
Procesa todos los audios |
| ๐ฆ ZIP | album.zip |
Extrae y procesa todo |
| ๐ฆ RAR | album.rar |
Requiere unrar |
| ๐ URL | youtube.com/watch?v=... |
Descarga y genera video |
| ๐ Playlist | youtube.com/playlist?list=... |
Descarga la lista completa |
Incluimos 4 portadas de ejemplo en docs/images/ para que pruebes LoopForge sin necesidad de crear tu propia imagen:
# Prueba rรกpida con una imagen incluida:
./loopforge.sh cancion.mp3 30 docs/images/test_cover_03.png -testerEdita las variables al inicio de loopforge.sh:
VIDEO_SIZE="1280x720" # Resoluciรณn del video
VIDEO_CRF=30 # Calidad (menor = mejor, rango: 18-28)
AUDIO_BITRATE="128k" # Bitrate de audio AAC
MIN_AUDIO_SECS=15 # Audios mรกs cortos se filtran
PARALLEL_JOBS=auto # Se detecta automรกticamente (CPU/RAM)Nota: El renderizado usa 2fps automรกticamente para imรกgenes estรกticas (mรกs rรกpido, mismo resultado en YouTube).
| Dependencia | Estado | Para quรฉ sirve |
|---|---|---|
ffmpeg + ffprobe |
Requerido | Procesamiento de audio/video |
yt-dlp |
Requerido | Descarga de URLs y playlists |
pymusiclooper |
Requerido | Detecciรณn de loop points |
ImageMagick |
Opcional | Mejor portada (fallback: ffmpeg) |
unrar |
Opcional | Archivos .rar |
jq |
Opcional | Conteo rรกpido de playlists |
Nota: Si ImageMagick no estรก instalado, LoopForge usa ffmpeg como fallback para procesar imรกgenes. Todo funciona igual.
- โก Procesamiento paralelo โ detecta tus nรบcleos CPU y RAM, ajusta trabajos solo
- ๐ต Detecciรณn inteligente de loop โ pymusiclooper analiza los puntos de repeticiรณn
- ๐ผ๏ธ Portada automรกtica โ fondo difuminado + imagen centrada (estilo YouTube)
- ๐ Sin duplicados โ elimina archivos idรฉnticos por hash MD5
- ๐ Playlists de YouTube โ descarga y procesa listas completas
- ๐งช Modo tester โ procesa 1 archivo para probar configuraciรณn
- โฐ Apagado programado โ apaga el PC despuรฉs de terminar (00:01-07:00)
- ๐ง๐ Multi-plataforma โ Linux y macOS
- ๐ช Sin dependencias raras โ solo 3 herramientas obligatorias
loopforge/
โโโ loopforge.sh # ๐ฅ Script principal
โโโ README.md # ๐ Este archivo
โโโ .gitignore # ๐ซ Archivos ignorados
โโโ docs/
โโโ images/
โโโ banner.png # ๐จ Banner del proyecto
โโโ test_cover_01.png # ๐ผ๏ธ Portada de prueba 1
โโโ test_cover_02.png # ๐ผ๏ธ Portada de prueba 2
โโโ test_cover_03.png # ๐ผ๏ธ Portada de prueba 3
โโโ test_cover_04.png # ๐ผ๏ธ Portada de prueba 4
MIT โ รsalo, modifรญcalo, compรกrtelo libremente.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Hecho con ๐ฅ para creadores de contenido en YouTube โ
โ Inspirado en el legado de BrawlBRSTMs3 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ



