Feature/add status sh file

.github/workflows/lint.yml

@@ -0,0 +1,41 @@
+name: Lint Scripts
+
+on:
+  push:
+    branches: [ main, master, "feature/**" ]
+  pull_request:
+    branches: [ main, master ]
+  workflow_dispatch:
+
+jobs:
+  shellcheck:
+    name: ShellCheck (Bash)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+
+      - name: Run ShellCheck
+        uses: ludeeus/action-shellcheck@master
+        with:
+          scandir: '.'
+          severity: style
+
+  psscriptanalyzer:
+    name: PSScriptAnalyzer (PowerShell)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - name: Run PSScriptAnalyzer
+        uses: microsoft/psscriptanalyzer-action@v1.1
+        with:
+          path: './PowerShell'
+          recurse: true
+          settings: PSGallery

PowerShell/DeleteEmptyFolders.ps1

@@ -1,21 +1,11 @@
-# DeleteEmptyFolders.ps1
-
-[CmdletBinding()]
-Param (
+<#
+.SYNOPSIS
+  Deletes empty subdirectories within a specified path (wrapper for ManageEmptyFolders.ps1).
+#>
+[CmdletBinding(SupportsShouldProcess = $true)]
+param (
     [Parameter(Mandatory = $true, Position = 0, HelpMessage = "The root path to search for empty folders.")]
     [string]$Path
 )
 
-# Validate that the path exists and is a directory
-if (-not (Test-Path -Path $Path -PathType Container)) {
-    Write-Error "The path '$Path' does not exist or is not a folder."
-    exit 1
-}
-
-Write-Verbose "Searching for empty folders under '$Path'..."
-
-# Get all directories recursively, then filter for those that have no child items (files or folders).
-# The results are sorted by the length of the FullName in descending order to ensure subdirectories are deleted before their parents.
-Get-ChildItem -Path $Path -Recurse -Directory | Where-Object { -not $_.GetFileSystemInfos() } | Sort-Object { $_.FullName.Length } -Descending | Remove-Item -Force -Verbose
-
-Write-Host "Finished deleting empty folders."
+& "$PSScriptRoot/ManageEmptyFolders.ps1" -Path $Path -Delete

PowerShell/DeleteFiles.ps1

@@ -0,0 +1,56 @@
+<#
+.SYNOPSIS
+    Deletes files based on path, filter, and age with safety dry-run support (-WhatIf).
+
+.DESCRIPTION
+    Safely removes files matching specified patterns and optionally older than a given number of days.
+    Supports -WhatIf and -Confirm standard PowerShell switches.
+
+.EXAMPLE
+    .\DeleteFiles.ps1 -Path "C:\Logs" -Filter "*.log" -DaysOld 30 -Recurse -WhatIf
+#>
+
+[CmdletBinding(SupportsShouldProcess = $true)]
+param(
+    [Parameter(Mandatory = $false, Position = 0)]
+    [string]$Path = ".",
+
+    [Parameter(Mandatory = $false)]
+    [string]$Filter = "*",
+
+    [Parameter(Mandatory = $false)]
+    [int]$DaysOld = 0,
+
+    [Parameter(Mandatory = $false)]
+    [switch]$Recurse
+)
+
+if (-not (Test-Path -Path $Path)) {
+    Write-Error "Target path '$Path' does not exist."
+    exit 1
+}
+
+$cutoffDate = (Get-Date).AddDays(-$DaysOld)
+
+$getParams = @{
+    Path    = $Path
+    Filter  = $Filter
+    File    = $true
+    Recurse = $Recurse
+}
+
+$filesToDelete = Get-ChildItem @getParams | Where-Object { $_.LastWriteTime -lt $cutoffDate }
+
+if ($filesToDelete.Count -eq 0) {
+    Write-Host "No files found matching criteria in '$Path'." -ForegroundColor Yellow
+    return
+}
+
+Write-Host "Found $($filesToDelete.Count) file(s) to process." -ForegroundColor Cyan
+
+foreach ($file in $filesToDelete) {
+    if ($PSCmdlet.ShouldProcess($file.FullName, "Delete file")) {
+        Remove-Item -Path $file.FullName -Force
+        Write-Host "Deleted: $($file.FullName)" -ForegroundColor Green
+    }
+}

PowerShell/FindEmptySubDirectories.ps1

@@ -1,15 +1,11 @@
-# findEmptySubDirectories.ps1
-
+<#
+.SYNOPSIS
+  Finds empty subdirectories within a specified path (wrapper for ManageEmptyFolders.ps1).
+#>
 [CmdletBinding()]
-Param(
+param (
     [Parameter(Mandatory = $true, Position = 0, HelpMessage = "The root path to search for empty directories.")]
     [string]$Path
 )
 
-if (-not (Test-Path -Path $Path -PathType Container)) {
-    Write-Error "The path '$Path' does not exist or is not a folder."
-    exit 1
-}
-
-# Get all directories recursively, then filter for those that have no child items (files or folders).
-Get-ChildItem -Path $Path -Recurse -Directory | Where-Object { -not $_.GetFileSystemInfos() } | Select-Object -ExpandProperty FullName
+& "$PSScriptRoot/ManageEmptyFolders.ps1" -Path $Path

PowerShell/ManageEmptyFolders.ps1

@@ -14,15 +14,15 @@
   A switch parameter that, if present, causes the script to delete the empty folders it finds.
 
 .EXAMPLE
-  .\Manage-EmptyFolders.ps1 -Path "C:\Users\Me\Documents"
+  .\ManageEmptyFolders.ps1 -Path "C:\Users\Me\Documents"
   Description: Lists all empty folders found under C:\Users\Me\Documents.
 
 .EXAMPLE
-  .\Manage-EmptyFolders.ps1 -Path "C:\Temp" -Delete
+  .\ManageEmptyFolders.ps1 -Path "C:\Temp" -Delete
   Description: Deletes all empty folders found under C:\Temp after prompting for confirmation.
 
 .EXAMPLE
-  .\Manage-EmptyFolders.ps1 -Path "C:\Temp" -Delete -WhatIf
+  .\ManageEmptyFolders.ps1 -Path "C:\Temp" -Delete -WhatIf
   Description: Shows which empty folders would be deleted under C:\Temp without actually deleting them.
 #>
 [CmdletBinding(SupportsShouldProcess = $true)]

README.md

@@ -1,11 +1,107 @@
-# scripts
+# Scripts Repository
 
-PowerShell (.ps1), python (.py), bash (.sh)
+A curated collection of automation scripts, tools, and utility modules for **Bash**, **PowerShell**, and **Docker**.
 
-## Bash
+---
 
-Different bash scripts
+## 🛠️ Repository Overview
 
-### NordVPN
+```
+.
+├── .github/
+│   └── workflows/
+│       └── lint.yml             # GitHub Actions CI workflow (ShellCheck & PSScriptAnalyzer)
+├── bash/
+│   ├── AutoRemoveSnapd.sh       # Removes snapd and associated packages on Debian/Ubuntu
+│   ├── countLines.sh            # Counts lines in a text file with line numbers
+│   ├── import-kali.sh           # Imports Kali Linux package repositories and GPG keys
+│   ├── docker/
+│   │   └── compose.yaml         # Docker Compose setup
+│   ├── encryption/
+│   │   ├── encrypt_file.sh      # AES-256-CBC file encryption (OpenSSL + PBKDF2)
+│   │   └── decrypt_file.sh      # AES-256-CBC file decryption (OpenSSL)
+│   └── nord/                    # NordVPN Meshnet control scripts
+│       ├── config.sh            # NordVPN configuration helper
+│       ├── connect.sh           # Connects to NordVPN
+│       ├── copy_scripts.sh      # Deployment helper script
+│       ├── exit_node.sh         # Manages and sets Meshnet exit node routing
+│       ├── list_peers.sh        # Lists Meshnet peers filtered by status
+│       ├── login.sh             # Interactive NordVPN login
+│       ├── logout.sh            # NordVPN logout
+│       ├── nord_watchdog.sh     # NordVPN connection watchdog daemon
+│       ├── reset.sh             # NordVPN settings reset
+│       └── set_nickname.sh      # Sets peer nickname in Meshnet
+└── PowerShell/
+    ├── CreateFile.ps1           # Creates test files of a specified size
+    ├── DeleteEmptyFolders.ps1   # Wrapper to delete empty subdirectories
+    ├── DeleteFiles.ps1          # Safe file deletion with age filtering & -WhatIf dry-run
+    ├── FindEmptySubDirectories.ps1 # Wrapper to find empty subdirectories
+    ├── ManageEmptyFolders.ps1   # Primary script for listing and removing empty folders
+    ├── ManageEmptyFolders.Function.ps1 # Reusable PowerShell function module
+    └── NextPVR.ps1              # NextPVR media recorder helper
+```
 
-Make me an exit_node god damn it!
+---
+
+## 🚀 Usage Guide
+
+### Bash Scripts (`bash/`)
+
+#### 🔐 File Encryption & Decryption (`bash/encryption/`)
+Encrypt and decrypt files using OpenSSL AES-256-CBC with PBKDF2 key derivation (100,000 iterations):
+
+```bash
+# Encrypt a file (prompts securely for passphrase)
+./bash/encryption/encrypt_file.sh document.pdf
+
+# Decrypt an encrypted file
+./bash/encryption/decrypt_file.sh document.pdf.enc
+```
+
+#### 🌐 NordVPN Meshnet Tools (`bash/nord/`)
+Manage NordVPN connections and Meshnet exit nodes:
+
+```bash
+# List online Meshnet peers
+./bash/nord/list_peers.sh online
+
+# Configure an exit node
+./bash/nord/exit_node.sh
+
+# Run watchdog daemon to monitor and maintain VPN connectivity
+./bash/nord/nord_watchdog.sh
+```
+
+---
+
+### PowerShell Scripts (`PowerShell/`)
+
+#### 📁 Empty Folder Cleanup (`PowerShell/ManageEmptyFolders.ps1`)
+Find or delete empty folder hierarchies (deepest nested folders deleted first):
+
+```powershell
+# List all empty subdirectories under a path
+.\PowerShell\ManageEmptyFolders.ps1 -Path "C:\Data"
+
+# Delete empty subdirectories safely with confirmation
+.\PowerShell\ManageEmptyFolders.ps1 -Path "C:\Data" -Delete
+
+# Dry-run deletion using -WhatIf
+.\PowerShell\ManageEmptyFolders.ps1 -Path "C:\Data" -Delete -WhatIf
+```
+
+#### 🧹 Safe File Cleanup (`PowerShell/DeleteFiles.ps1`)
+Remove files matching a filter pattern and age threshold:
+
+```powershell
+# Delete .log files older than 30 days under C:\Logs (dry-run mode)
+.\PowerShell\DeleteFiles.ps1 -Path "C:\Logs" -Filter "*.log" -DaysOld 30 -Recurse -WhatIf
+```
+
+---
+
+## 🤖 Code Quality & CI
+
+This repository uses [GitHub Actions](file:///.github/workflows/lint.yml) to ensure code quality on every push and pull request:
+- **ShellCheck**: Static analysis for all `.sh` scripts.
+- **PSScriptAnalyzer**: Best-practice rules for `.ps1` scripts.

bash/AutoRemoveSnapd.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/bash
+#!/usr/bin/env bash
 
 sudo apt autoremove snapd
 

bash/countLines.sh

@@ -1,4 +1,4 @@
-#! /usr/bin/bash
+#!/usr/bin/env bash
 FILENAME="$1"
 echo "$FILENAME"
 COUNTER=0