Add README documentation

Author: Daniel Sundberg

README.md

@@ -0,0 +1,31 @@
+# CopyImages
+
+Powershell script to copy files from memory card to folder on disk.
+
+## Usage:
+<code>
+.\copy-images.ps1 -indir "e:" -outdir "c:\images" -today
+</code>
+
+<code>
+.\copy-images.ps1 -indir "e:" -outdir "c:\images" -from "2015-01-01" -to "2015-02-28"
+</code>
+
+## Optional switches
+<code>
+-ymdPath
+</code>
+
+When set to **true**, create paths in **outdir** on the format **\yyyy\mm\dd**
+(year (4 digits)/month (2 digits)/day of month (2 digits)). This is the default
+behavior. Set to **false** if you want paths of format **yyyy-mm-dd**.
+
+## Possible improvements
+* Handle more raw file extensions
+* Start cmdlet when memory card is inserted
+* Handle more camera models if needed (tested with Nikon D40 and Sony RX100)
+* Improve dry-run output
+* Log to file as default
+* Auto detect memory card path
+* Remember input and output dir
+* Config file for input/output dir

copy-images.ps1

@@ -1,12 +1,3 @@
-# Possible improvements
-# -Handle more raw file formats
-# -Start cmdlet when memory card is inserted
-# -Handle more camera models
-# -Improve dry-run output
-# -Log to file as default
-# -Log levels for debugging
-
-
 param (
     [switch]$dryRun = $false,
     [string]$indir = "e:\",
@@ -23,12 +14,12 @@ trap
 	write-output $_
 	exit 1
 }
- 
+
 $rawFiles = "*.NEF"
 $jpgFiles = "*.JPG"
 
 $rawOutdir = join-path -Path $outdir -ChildPath "Raw"
- 
+
 # Parse dates
 $fromDate = [DateTime]::MinValue
 if ($from.length -gt 0)
@@ -47,7 +38,7 @@ if ($today)
 	$fromDate = (get-date).date
 	$toDate = (get-date).date.AddDays(1)
 }
- 
+
 echo "Starting..."
 echo "In dir:    $indir"
 echo "Out dir:   $outdir"
@@ -74,14 +65,14 @@ foreach ($item in $files)
 	echo "$i of $nofFiles"
 	$i += 1
 	$date = $item | get-date
-	
+
 	# Check that file date is in our date interval
 	if (($date -gt $fromDate) -and ($date -lt $toDate))
 	{
 		$shortDate = $date.ToString("yyyy-MM-dd")
 		$fullName = $item.FullName
 		$name = $item.Name
-		
+
 		if ($item.Extension.ToUpper() -eq ".NEF")
 		{
 			$destPath = join-path -Path $outdir -ChildPath "Raw"
@@ -90,14 +81,14 @@ foreach ($item in $files)
 		{
 			$destPath = $outdir
 		}
-		
+
 		# Create destination path of specified format <out_path>\<date>
 		# or <out_path>\year\mm\<date>
 		if ($ymdPath)
 		{
 			$destPath = join-path -Path (join-path -Path (join-path -Path $destPath -ChildPath $date.year) -ChildPath $date.month) -ChildPath $shortDate
 		}
-		else 
+		else
 		{
 			$destPath = join-path -Path $destPath -ChildPath $shortDate
 		}
@@ -110,9 +101,9 @@ foreach ($item in $files)
 				mkdir $destPath
 			}
 		}
-		
+
 		$destFile = join-path -Path $destPath -ChildPath $name
-		
+
 		if (!(Test-Path -Path $destFile))
 		{
 			echo "Copying $fullName to $destFile..."
@@ -123,4 +114,3 @@ foreach ($item in $files)
 		}
 	}
 }
-