Skip to content

Una herramienta CLI (Línea de Comandos) escrita en C para organizar fotos y videos automáticamente basándose en sus metadatos reales (EXIF).

License

Notifications You must be signed in to change notification settings

Lstrappare/PhotoShell

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

PhotoShell

Una herramienta CLI (Línea de Comandos) escrita en C para organizar fotos y videos automáticamente basándose en sus metadatos reales (EXIF).

Screenshot 2026-01-17 at 1 12 55 a m

C License

✨ Características

  • Detecta fechas reales: Lee metadatos EXIF de JPG, PNG, HEIC y QuickTime (MOV/MP4).
  • Shell Interactiva: Incluye su propia mini-terminal para navegar carpetas (ls, cd).
  • Fallback Inteligente: Si un archivo no tiene metadatos (descargado de internet), usa la fecha de modificación del archivo para no perderlo.
  • Renombrado Automático: Formato YYYY-MM-DD_HH-MM-SS.ext.
  • Anti-Colisiones: Evita sobrescribir archivos con el mismo nombre (agrega _1, _2, etc.).

🚀 Requisitos Previos

El programa utiliza ExifTool como motor de lectura de metadatos.

macOS

  1. Instala Homebrew si no lo tienes.
  2. Ejecuta en tu terminal:
    brew install exiftool

Windows

  1. Descarga el ejecutable de ExifTool.

  2. Descomprime el archivo y renombra exiftool(-k).exe a exiftool.exe.

  3. Mueve exiftool.exe a la carpeta C:\Windows (para que sea accesible globalmente) O ponlo en la misma carpeta donde compiles este programa.

🛠️ Instalación y Compilación

  1. Clonar el repositorio git clone https://github.com/Lstrappare/PhotoShell.git

  2. Compilar

Usando GCC (Mac/Linux/Windows con MinGW): gcc main.c -o photoshell

📖 Cómo Usar

  1. Ejecuta el programa:
./photoshell
  1. Verás la terminal interactiva:
👤 photo-shell:[/Users/TuUsuario] $
  1. Navega hasta tu carpeta de fotos desordenadas usando comandos:
  • ls: Ver archivos.

  • cd Carpeta: Entrar a una carpeta.

  • cd ..: Regresar atrás.

  1. Una vez dentro de la carpeta a ordenar, escribe:
organizar
  1. El programa te pedirá la ruta de destino. Escríbela y pulsa Enter.
  • Ejemplo destino: /Users/TuUsuario/Pictures/Ordenadas

⚠️ Notas

El programa crea copias o mueve archivos (según tu SO y configuración). Se recomienda probar primero con una carpeta de copia de seguridad.

Soporta: .jpg, .jpeg, .png, .heic, .mp4, .mov, .gif.

About

Una herramienta CLI (Línea de Comandos) escrita en C para organizar fotos y videos automáticamente basándose en sus metadatos reales (EXIF).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages