How esther7171/scripts works
Project type and purpose
• This is a “scripts library” repository: a collection of small automation utilities (PowerShell, VBScript, Bash, Python) that the author uses to expedite daily tasks on Windows and Linux.
• The primary use cases:
• Windows folder locking (FolderLock.ps1)
• Forwarding honeypot logs to Telegram (telegram.py)
• One‐liner installers or updaters for Linux (Install-snap-store.sh, update, linpeas.sh)
• Automated shutdown on Windows (shut.vbs)
• Miscellaneous documentation (bluetooth.md, shutdown.md, cis.csv).
File structure
• Top-level items:
• Two feature folders for multi-file scripts (Folder-Protection-Script-for-Windows and Forward-Honeypot-Log-to-Telegram).
• Individual scripts at root (Install-snap-store.sh, linpeas.sh, update).
• One VBScript folder (Shutdown).
• Miscellaneous docs (bluetooth.md, shutdown.md, cis.csv).
• No build system or compiled binaries—each script runs in its native environment.
• Deployment hint: users are instructed to move scripts into /usr/local/bin to make them global commands.
README for additional insights
• The README is brief: it describes the collection’s intent (daily‐base task automation) and gives a “make scripts into commands” snippet.
a. Main components:
– User (invoker)
– Linux environment (Bash shell)
– Windows environment (PowerShell host, Windows Scripting Host for VBScript)
– Scripts subcomponents:
• FolderLock.ps1
• shut.vbs
• telegram.py
• Bash utilities (Install-snap-store.sh, update, linpeas.sh)
– External service: Telegram Bot API
– File system (local folders, /usr/local/bin)
b. Relationships and interactions:
– User → launches script on appropriate OS
– Bash scripts → local package manager or file system operations
– telegram.py → forwards logs to Telegram Bot endpoint over HTTPS
– FolderLock.ps1 → invokes PowerShell file attributes & encryption APIs
– shut.vbs → calls WSH shutdown method
c. Architectural patterns and principles:
– Single-responsibility: each script handles one task
– Environment separation: Linux vs. Windows runtimes
– External integration: Python script as the only script requiring an external API
d. Key technologies & frameworks:
– PowerShell engine (.ps1)
– Windows Scripting Host (.vbs)
– Bash shell on Linux
– Python 3 + requests (or built-in urllib) for Telegram forwarding
Detail over complexity
• Environment prerequisites: “Python 3 installed” or “PowerShell v5+” in small annotation callouts.