EJ Tools

CLI para descargar vídeo y audio (YouTube, Instagram, TikTok, X y más).
Python + yt-dlp + Rich, con intro animada y menú interactivo.

Features

• Vídeo hasta 4K (con audio o solo imagen)
• Extracción a MP3 (320 / 192 / 128 kbps)
• Selección robusta de formatos (incluye Shorts verticales)
• Carpeta de descarga configurable
• Intro animada + menú neon
• Build Windows .exe con PyInstaller

Prerequisites

1. Python 3.8+ (solo si corres desde fuente)
2. FFmpeg en el PATH o junto al ejecutable / script

FFmpeg

• Windows: pon ffmpeg.exe (y si puedes ffprobe.exe) en la misma carpeta que EJTools.exe / el repo, o instálalo en el PATH.
• macOS / Linux: brew install ffmpeg o sudo apt install ffmpeg

Installation (desde fuente)

git clone https://github.com/JairoMS27/ej_tools.git
cd ej_tools
python -m venv venv
# Windows:
venv\Scripts\activate
pip install -r requirements.txt
python main.py

Usage

python main.py

1. Elige vídeo con audio, vídeo sin audio o solo audio
2. Pega el enlace
3. Elige calidad
4. Listo

La config local se guarda en settings.json (ignorado por git; es por máquina).

Añadir ejtools al PATH (Windows)

Para abrir el programa escribiendo ejtools en cualquier terminal:

1. Carpeta fija del exe

Crea una carpeta estable, por ejemplo:

C:\Users\<TU_USUARIO>\bin

Copia ahí:

• EJTools.exe (del release o de dist\)
• ffmpeg.exe (recomendado, misma carpeta)

2. Lanzador ejtools.cmd

En esa misma carpeta, crea ejtools.cmd con:

@echo off
"%~dp0EJTools.exe" %*

3. Añadir la carpeta al PATH de usuario

PowerShell:

$bin = "$env:USERPROFILE\bin"
New-Item -ItemType Directory -Force -Path $bin | Out-Null
# (copia EJTools.exe, ffmpeg.exe y ejtools.cmd a $bin)
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($userPath -notlike "*$bin*") {
  [Environment]::SetEnvironmentVariable("Path", "$userPath;$bin", "User")
}

Cierra y abre la terminal. Prueba:

ejtools

Nota: los cambios de PATH no aplican a terminales ya abiertas.

Building the executable

pip install -r requirements.txt pyinstaller
pyinstaller EJTools.spec

Salida: dist/EJTools.exe

Copia ffmpeg.exe al lado del .exe antes de repartirlo o de meterlo en el PATH.

Contributing

1. Fork
2. Branch (git checkout -b feature/mi-cambio)
3. Commit + push
4. Pull Request

Author

@ej3mplo · X/Twitter

Repo: JairoMS27/ej_tools

License

MIT