# ๐Ÿ“‹ Clipboard Vault (PowerShell 7.5) ## Overview A powerful clipboard manager for PowerShell 7.5. It captures everything you copy and provides a rich, searchable history through an interactive HTML interface. It's designed to be a "vault" for your clipboard, preventing data loss and making it easy to find previously copied items. ## Functionality * **Live Clipboard Monitoring:** Continuously captures text copied to the clipboard. * **Interactive HTML Viewer:** Automatically generates a `Clipboard-Viewer.html` file to browse, search, and manage your history. * **Intelligent De-duplication:** When you re-copy an item, it's moved to the top of the history instead of creating a duplicate entry. * **Powerful Search:** The HTML viewer supports real-time searching of your clipboard history, including regular expressions. * **One-Click Copy:** Easily copy any item from the history back to your clipboard. * **Database Cleanup:** A feature in the viewer allows you to remove all historical duplicates, keeping only the most recent unique entries. * **JSON Storage:** History is stored in a clean, human-readable `clipboard_history.json` file. ## Usage 1. Ensure `Clipboard-Manager.ps1` and `Clipboard-Functions.ps1` are in the same directory. 2. Open a PowerShell 7 terminal. 3. Navigate to the script's directory. 4. Run the script: `.\Clipboard-Manager.ps1` 5. The script will start monitoring. To view your history, open the `Logs\Clipboard-Viewer.html` file that is created in the script's directory. The viewer updates as you copy new items. 6. To stop the script, press `Ctrl+C` in the PowerShell window. ## Requirements * PowerShell 7.5 or later * Windows operating system ## Code Example ```PowerShell # Configuration $LogDir = "$PSScriptRoot\Logs" $ClipboardLogFile = "$LogDir\clipboard_history.json" $MaxHistoryItems = 50 # Ensure log directory exists if (!(Test-Path $LogDir)) { New-Item -ItemType Directory -Path $LogDir | Out-Null } Write-Host "--- Clipboard Vault Active ---" -ForegroundColor Cyan Write-Host "Press 'Ctrl+C' in this window to stop monitoring." -ForegroundColor Gray function Update-HtmlViewer { param($History) $HtmlPath = "$PSScriptRoot\Logs\Clipboard-Viewer.html" $Header = @" Clipboard Vault Viewer

๐Ÿ“‹ Clipboard Vault

"@ $Body = "" foreach ($Item in $History) { $EscapedContent = [System.Web.HttpUtility]::HtmlEncode($Item.Content) $Body += @"
$($Item.Timestamp)
$EscapedContent
"@ } $Footer = @"
"@ $Header + $Body + $Footer | Out-File $HtmlPath -Force } $LastContent = "" # The "Engine" try { while ($true) { # Fetch clipboard text (PS 7.5 compatible) $CurrentContent = Get-Clipboard -Raw -ErrorAction SilentlyContinue # Inside your while ($true) loop, at the very beginning: $ReqFile = "$LogDir\cleanup.req" if (Test-Path $ReqFile) { Write-Host "๐Ÿงน Cleanup Requested! Removing duplicates..." -ForegroundColor Yellow if (Test-Path $ClipboardLogFile) { $CurrentHistory = Get-Content $ClipboardLogFile | ConvertFrom-Json # This magic line keeps only the newest unique hash $CleanedHistory = $CurrentHistory | Group-Object Hash | ForEach-Object { $_.Group | Select-Object -First 1 } # Sort back by time (Newest first) $CleanedHistory = $CleanedHistory | Sort-Object Timestamp -Descending # Save and Update $CleanedHistory | ConvertTo-Json | Out-File $ClipboardLogFile -Force Update-HtmlViewer -History $CleanedHistory } Remove-Item $ReqFile -ErrorAction SilentlyContinue Write-Host "โœจ Database Cleaned." -ForegroundColor Green } # Inside your while($true) loop: if ($null -ne $CurrentContent -and $CurrentContent -ne $LastContent) { $LastContent = $CurrentContent $History = if (Test-Path $ClipboardLogFile) { Get-Content $ClipboardLogFile | ConvertFrom-Json } else { @() } # Create a unique ID based on the content so we can identify duplicates $ContentHash = [Convert]::ToBase64String([System.Security.Cryptography.SHA256]::Create().ComputeHash([System.Text.Encoding]::UTF8.GetBytes($CurrentContent))) # Remove the old version if it exists (so it "jumps" to the top instead of duplicating) $History = $History | Where-Object { $_.Hash -ne $ContentHash } $NewEntry = [PSCustomObject]@{ Timestamp = (Get-Date).ToString("HH:mm:ss") Hash = $ContentHash # Add this! Content = $CurrentContent.Trim() } $History = ,$NewEntry + $History | Select-Object -First $MaxHistoryItems $History | ConvertTo-Json | Out-File $ClipboardLogFile -Force Update-HtmlViewer -History $History } # Check if it's new, not null, and not just empty whitespace if ($null -ne $CurrentContent -and $CurrentContent -ne $LastContent -and !([string]::IsNullOrWhiteSpace($CurrentContent))) { $LastContent = $CurrentContent # Load existing history $History = if (Test-Path $ClipboardLogFile) { Get-Content $ClipboardLogFile | ConvertFrom-Json } else { @() } # Create a new Entry $NewEntry = [PSCustomObject]@{ Timestamp = (Get-Date).ToString("yyyy-MM-dd HH:mm:ss") Content = $CurrentContent.Trim() } # Add to history (Newest at top) $History = ,$NewEntry + $History | Select-Object -First $MaxHistoryItems # Save to JSON $History | ConvertTo-Json -Depth 3 | Out-File $ClipboardLogFile -Force # Update HTML Viewer Update-HtmlViewer -History $History # Visual Feedback $Display = if ($CurrentContent.Length -gt 40) { $CurrentContent.Substring(0,40).Trim() + "..." } else { $CurrentContent.Trim() } Write-Host "[$(Get-Date -Format HH:mm:ss)] ๐Ÿ“‹ Captured: $Display" -ForegroundColor Green } Start-Sleep -Milliseconds 500 } } catch { Write-Error "Vault Error: $($_.Exception.Message)" } finally { Write-Host "`nVault Closed." -ForegroundColor Yellow } ```