Folder Sorter

PREVIEW ONLY - nothing will be moved. Re-run with -Apply to perform these moves.
(this tool only ever moves files; it never deletes or overwrites)

Audio/  (1 files)
  song.mp3  ->  Audio/
Documents/  (2 files)
  invoice.pdf  ->  Documents/
  notes.txt  ->  Documents/
Images/  (1 files)
  beach.jpg  ->  Images/
Installers/  (1 files)
  setup.msi  ->  Installers/

Preview complete. Re-run with -Apply to perform these moves.

<#
.SYNOPSIS
  Sort-DownloadsFolder - sorts a messy folder into subfolders by file type.

.DESCRIPTION
  SAFE BY DEFAULT: prints a preview of what would move and changes nothing
  until you pass -Apply. Never deletes anything. Never overwrites: a name
  collision is reported and skipped. Ignores hidden files and files with no
  extension. Moves top-level files only, never into subfolders recursively.

.EXAMPLE
  powershell -ExecutionPolicy Bypass -File .\Sort-DownloadsFolder.ps1 -Path $HOME\Downloads
.EXAMPLE
  powershell -ExecutionPolicy Bypass -File .\Sort-DownloadsFolder.ps1 -Path $HOME\Downloads -Apply
#>
[CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')]
param(
  [string]$Path = (Join-Path $HOME 'Downloads'),
  [switch]$Apply
)

$groups = @{
  'Documents' = @('.pdf','.doc','.docx','.odt','.rtf','.txt','.md','.xls','.xlsx','.ods','.csv','.ppt','.pptx','.odp')
  'Images'    = @('.jpg','.jpeg','.png','.gif','.webp','.bmp','.svg','.heic','.raw','.cr2','.nef')
  'Video'     = @('.mp4','.mkv','.avi','.mov','.wmv','.flv','.webm','.m4v')
  'Audio'     = @('.mp3','.wav','.flac','.aac','.ogg','.m4a','.wma')
  'Archives'  = @('.zip','.rar','.7z','.tar','.gz','.bz2','.xz','.iso')
  'Code'      = @('.js','.ts','.py','.ps1','.sh','.html','.css','.json','.xml','.c','.cpp','.java','.go','.rs','.rb')
  'Installers'= @('.exe','.msi','.dmg','.deb','.rpm','.appimage')
}

function Get-Group([string]$ext) {
  foreach ($g in $groups.Keys) { if ($groups[$g] -contains $ext.ToLower()) { return $g } }
  return 'Other'
}

if (-not (Test-Path -LiteralPath $Path -PathType Container)) {
  Write-Error "Not a folder: $Path"
  exit 1
}

if ($Apply) { Write-Host "APPLYING moves in: $Path" }
else        { Write-Host "PREVIEW ONLY - nothing will be moved. Re-run with -Apply to perform these moves." }
Write-Host '(this tool only ever moves files; it never deletes or overwrites)'
Write-Host ''

$files = Get-ChildItem -LiteralPath $Path -File -Force -ErrorAction SilentlyContinue |
  Where-Object { -not $_.Name.StartsWith('.') -and $_.Extension -ne '' }

if (-not $files) {
  Write-Host 'Nothing to organize (no regular files with an extension found).'
  exit 0
}

$plan = @{}
foreach ($f in $files) {
  $g = Get-Group $f.Extension
  if (-not $plan.ContainsKey($g)) { $plan[$g] = @() }
  $plan[$g] += $f
}

foreach ($g in ($plan.Keys | Sort-Object)) {
  Write-Host ("{0}/  ({1} files)" -f $g, $plan[$g].Count)
  foreach ($f in $plan[$g]) {
    $destDir = Join-Path $Path $g
    $dest    = Join-Path $destDir $f.Name
    if ($Apply) {
      if (-not (Test-Path -LiteralPath $destDir)) {
        New-Item -ItemType Directory -Path $destDir -Force | Out-Null
      }
      if (Test-Path -LiteralPath $dest) {
        Write-Host ("  skipped  {0}  (a file with that name already exists)" -f $f.Name)
        continue
      }
      if ($PSCmdlet.ShouldProcess($f.FullName, "Move to $dest")) {
        Move-Item -LiteralPath $f.FullName -Destination $dest -ErrorAction Stop
        Write-Host ("  moved    {0}" -f $f.Name)
      }
    } else {
      Write-Host ("  {0}  ->  {1}/" -f $f.Name, $g)
    }
  }
}
Write-Host ''
if ($Apply) { Write-Host 'Done. Review the folders and delete anything you no longer need - manually.' }
else        { Write-Host 'Preview complete. Re-run with -Apply to perform these moves.' }

#!/usr/bin/env bash
# file-organizer.sh - sorts a messy folder into subfolders by file type.
# SAFE BY DEFAULT: prints a preview and changes nothing until -apply.
# Never deletes anything. Never overwrites: a name collision is skipped.
# Ignores hidden files and files with no extension. Top-level only.
# Run: bash file-organizer.sh [path]
#      bash file-organizer.sh [path] -apply

set -u

PATH_TO_SORT="${1:-$HOME/Downloads}"
APPLY="${2:-}"

if [ ! -d "$PATH_TO_SORT" ]; then
  echo "Not a folder: $PATH_TO_SORT" >&2
  exit 1
fi

group_for() {
  case "$1" in
    .pdf|.doc|.docx|.odt|.rtf|.txt|.md|.xls|.xlsx|.ods|.csv|.ppt|.pptx|.odp) echo "Documents" ;;
    .jpg|.jpeg|.png|.gif|.webp|.bmp|.svg|.heic|.raw|.cr2|.nef) echo "Images" ;;
    .mp4|.mkv|.avi|.mov|.wmv|.flv|.webm|.m4v) echo "Video" ;;
    .mp3|.wav|.flac|.aac|.ogg|.m4a|.wma) echo "Audio" ;;
    .zip|.rar|.7z|.tar|.gz|.bz2|.xz|.iso) echo "Archives" ;;
    .js|.ts|.py|.ps1|.sh|.html|.css|.json|.xml|.c|.cpp|.java|.go|.rs|.rb) echo "Code" ;;
    .exe|.msi|.dmg|.deb|.rpm|.appimage) echo "Installers" ;;
    *) echo "Other" ;;
  esac
}

if [ "$APPLY" = "-apply" ]; then
  echo "APPLYING moves in: $PATH_TO_SORT"
else
  echo "PREVIEW ONLY - nothing will be moved. Re-run with -apply to perform these moves."
fi
echo "(this tool only ever moves files; it never deletes or overwrites)"
echo ""

# Collect top-level regular files with an extension, skipping dotfiles.
files=$(find "$PATH_TO_SORT" -maxdepth 1 -type f ! -name '.*' 2>/dev/null)

if [ -z "$files" ]; then
  echo "Nothing to organize (no regular files with an extension found)."
  exit 0
fi

for g in Documents Images Video Audio Archives Code Installers Other; do
  count=0
  lines=""
  while IFS= read -r f; do
    [ -z "$f" ] && continue
    base=$(basename "$f")
    case "$base" in
      *.*) ;;
      *) continue ;;
    esac
    ext=".${base##*.}"
    [ "$(group_for "$ext")" = "$g" ] || continue
    count=$((count + 1))
    lines="$lines$f
"
  done <<EOF
$files
EOF
  [ "$count" -eq 0 ] && continue
  echo "$g/  ($count files)"
  echo "$lines" | while IFS= read -r f; do
    [ -z "$f" ] && continue
    base=$(basename "$f")
    if [ "$APPLY" = "-apply" ]; then
      dest_dir="$PATH_TO_SORT/$g"
      mkdir -p "$dest_dir"
      dest="$dest_dir/$base"
      if [ -e "$dest" ]; then
        echo "  skipped  $base  (a file with that name already exists)"
      elif mv "$f" "$dest" 2>/dev/null; then
        echo "  moved    $base"
      else
        echo "  FAILED   $base  (could not move)"
      fi
    else
      echo "  $base  ->  $g/"
    fi
  done
done

echo ""
if [ "$APPLY" = "-apply" ]; then
  echo "Done. Review the folders and delete anything you no longer need - manually."
else
  echo "Preview complete. Re-run with -apply to perform these moves."
fi