mrg - herramienta para resolver la separación de jamo en macOS y eliminar archivos de metadatos innecesarios

mrg es una utilidad CLI que se usa para eliminar varios archivos innecesarios que genera macOS o para normalizar nombres de archivo en Unicode.

Funciones de mrg

• Normalización NFC de nombres de archivo Unicode (--bad-unicode): resuelve el problema de separación de jamo.
• Eliminación de archivos .DS_Store (--ds-store): elimina los archivos .DS_Store que se crean al abrir carpetas con Finder.
• Eliminación de archivos ._* (--dot): elimina los archivos ._* donde macOS guarda metadatos o información de indexación.

Características de mrg

• Soporte de colores ANSI: mrg soporta colores atractivos en la terminal. Con los colores puedes identificar intuitivamente el estado del directorio. Por supuesto, también se puede desactivar mediante la variable de entorno NO_COLOR.
• Reportes de análisis visuales: al escanear o limpiar con mrg, se presentan reportes visuales del resultado. Esto permite revisar de un vistazo qué fue lo que mrg escaneó y limpió.
• Reportes de análisis en JSON: además del análisis visual para personas, también se ofrece análisis en formato JSON legible por máquinas.
• API de Python: mrg también puede usarse como módulo de Python. A través del módulo mrg de Python, puedes ejecutar o personalizar mrg desde Python.
• Sin dependencias externas: en tiempo de ejecución, mrg no utiliza ninguna biblioteca externa aparte de las librerías estándar incluidas por defecto en Python.

Instalación

Puedes instalar mrg mediante homebrew.

brew tap ilotoki0804/homebrew-mrg  
brew install mrg  

Si usas uv, también puedes instalarlo con uvx mrg.

Uso

Por defecto, mrg recibe una ruta como argumento. Para inspeccionar un directorio, solo tienes que escribir la ruta después del comando mrg, como se muestra a continuación.

mrg .  

Si lo ejecutas así, sin otros argumentos, entrará por defecto en el “modo de escaneo”.
En este estado no modifica ningún archivo; simplemente inspecciona el estado del directorio y entrega los resultados del análisis.

Si quieres realmente limpiar o modificar archivos, debes agregar argumentos. Puedes limpiar el directorio usando uno o más de los siguientes argumentos.

• --dot: elimina archivos ._*. Por defecto, solo los elimina si tienen un tamaño típico y existe el archivo correspondiente.
• --bad-unicode: normaliza nombres de archivos/carpetas Unicode que no estén normalizados en NFC.
• --ds-store: elimina archivos .DS_Store.

Por ejemplo, si quieres normalizar a NFC todos los archivos y directorios dentro del directorio ., puedes usar el siguiente comando.

mrg . --bad-unicode  

Si quieres ejecutar --bad-unicode, --ds-store y --dot al mismo tiempo, puedes usar la bandera --all.

mrg . --all  

mrg es un acrónimo de un juego de palabras coreano que combina macOS con “basura”, en el sentido de limpiar archivos basura generados por macOS.

Para una explicación completa, consulta el enlace. Es una herramienta de código abierto publicada bajo Apache 2.0, y son bienvenidos los PR, issues y demás contribuciones.

Documentación (coreano) / Documentación (inglés)