Encodage du script + Readme

ArrangePictures.ps1

@@ -1,4 +1,4 @@
-# Fonction pour récupérer une Array des extensions d'images et vidéos depuis un json
+# Fonction pour récupérer une Array des extensions d'images et vidéos depuis un json
 function Get-ImageVideoExtensions {
     param (
         [string] $sourceUrl = "https://cdn.jsdelivr.net/gh/jshttp/mime-db@v1.52.0/db.json"
@@ -16,7 +16,7 @@ function Get-ImageVideoExtensions {
     return $extensions
 }
 
-# Fonction pour décompresser les archives
+# Fonction pour décompresser les archives
 function Decompress-ArchiveIfNeeded {
     param(
         [string]$ArchivePath,
@@ -35,12 +35,12 @@ function Decompress-ArchiveIfNeeded {
     return $null
 }
 
-# Fonction pour obtenir la date de création d'une image/vidéo
+# Fonction pour obtenir la date de création d'une image/vidéo
 function Get-OriginalDate {
     param (
         $file
     )
-    # Tentative de lecture des données EXIF
+    # Tentative de lecture des données EXIF
     $exif = Try { [System.Drawing.Image]::FromFile($file.FullName) } Catch { $null }
 
     if ($exif) {
@@ -58,7 +58,7 @@ function Get-OriginalDate {
     }
 }
 
-# Demande des paramètres si non fournis
+# Demande des paramètres si non fournis
 if (-not $args[0] -or -not $args[1]) {
     $SourceDir = Read-Host "Entrez le chemin du dossier source"
     $DestinationDir = Read-Host "Entrez le chemin du dossier destination"
@@ -67,24 +67,24 @@ if (-not $args[0] -or -not $args[1]) {
     $DestinationDir = $args[1]
 }
 
-# Vérifie si le dossier source est une archive
+# Vérifie si le dossier source est une archive
 if ($SourceDir -match "\.zip$") {
     $SourceDir = Decompress-ArchiveIfNeeded -ArchivePath $SourceDir -ExtractPath $env:TEMP
     if (-not $SourceDir) {
-        Write-Host "L'archive n'a pas pu être décompressée."
+        Write-Host "L'archive n'a pas pu être décompressée."
         return
     }
 }
 
 $validExtensions = Get-ImageVideoExtensions
 
-# Parcourt tous les fichiers récursivement dans le dossier source
+# Parcourt tous les fichiers récursivement dans le dossier source
 Get-ChildItem -Path $SourceDir -Recurse -File | ForEach-Object {
     $file = $_
     $extension = $file.Extension.ToLower().TrimStart('.')
 
     if ($extension -in $validExtensions) {
-        # Tentative de lecture des données EXIF
+        # Tentative de lecture des données EXIF
         $exif = Try { [System.Drawing.Image]::FromFile($file.FullName) } Catch { $null }
 
         if ($exif) {
@@ -102,9 +102,9 @@ Get-ChildItem -Path $SourceDir -Recurse -File | ForEach-Object {
         }
         
         if (-Not $originalDate) {
-            $targetFolder = Join-Path -Path $DestinationDir -ChildPath "Non daté"
+            $targetFolder = Join-Path -Path $DestinationDir -ChildPath "Non daté"
         } else {
-            # Créer le dossier de destination basé sur l'année et le mois
+            # Créer le dossier de destination basé sur l'année et le mois
             $year = $originalDate.Year
             $monthNum = $originalDate.Month.ToString("00")
             $monthName = $originalDate.ToString("MMMM", [System.Globalization.CultureInfo]::GetCultureInfo("fr-FR"))
@@ -118,11 +118,11 @@ Get-ChildItem -Path $SourceDir -Recurse -File | ForEach-Object {
         # Copier le fichier dans le dossier de destination
         Copy-Item -Path $file.FullName -Destination $targetFolder
     } else {
-        Write-Host "Fichier ignoré: $($file.FullName)"
+        Write-Host "Fichier ignoré: $($file.FullName)"
     }
 }
 
-# Suppression du dossier temporaire si nécessaire
+# Suppression du dossier temporaire si nécessaire
 if ($SourceDir -like "$env:TEMP\*") {
     Remove-Item -Path $SourceDir -Recurse -Force
 }

README.md

@@ -1,5 +1,18 @@
-# PicturesArrangerScript
+# PicturesArranger
 
-Ce script Powershell récupère les fichiers images/vidéos contenus dans une source et les copie dans une destination en les rangeant selon une arborescence <année>/<mois> qui se base sur la date de création des fichiers.
+Ce script Powershell récupère les fichiers images/vidéos contenus dans une source et les copie dans une destination en les rangeant selon une arborescence qui se base sur la date de création des fichiers.
 
-Je l'utilise pour trier d'un bloc toutes mes données dans mon SSD externe.
+Je l'utilise pour trier d'un bloc toutes mes données dans mon SSD externe.
+
+## Utilisation
+
+Vous pouvez lancer le script depuis l'explorateur de fichiers Windows en faisant clic droit dessus puis en sélectionnant "Exécuter avec Powershell"
+
+![Illustration.](/images/readme_img1.png "Exécuter avec Powershell")
+
+Il vous demandera deux chemins ; Le premier vers le dossier source ou récupérer les fichiers, vous pouvez aussi lui donner une archive qu'il décompressera le temps de l'exécution, le deuxième vers le dossier destination ou ranger les images récupérées, il le créera si besoin.
+
+Vos fichiers rangées dans des sous-dossiers par année puis par mois en se basant sur la date où le fichier a été créé pour la première fois.
+Par exemple "2023\\03 - Mars\\"
+
+Il arrive que certains fichiers ne puissent être datés et soient rangés dans un dossier "Non daté"