Shell-X-Bot🤖

You can read in:

Deutsch | Español | Français | हिंदी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | नेपाली | Nederlands | Português | Русский | ไทย | 中文

These translations are generated by the system, so they may be inaccurate. Please prefer the English documentation for better understanding.

Overview

It allows users to execute various commands directly from Telegram, leveraging PowerShell's capabilities to manage their Windows environment.

⭐ Star this project if you find it useful!

🚀 Features

• Command Execution: Run commands from Telegram to interact with your Windows system.
• File Management: Create, delete, and see system files.
• System Information: Retrieve and display system stats, hardware info, and current directory.
• User Interactions: Send welcome messages and handle commands in a user-friendly way.
• Remote Control: Log off, lock, restart, or shut down the computer remotely.

📦 Prerequisites

Before you start, ensure you have the following requirement:

• Windows Operating System
• A bot to receive notifications on Telegram.
• Required PowerShell modules installed:
  • Microsoft.PowerShell.Security
  • Microsoft.PowerShell.Utility
  • NetworkConnectivityStatus
  • NetworkSwitchManager

⚙️ Installation

1. Clone the Repository: git clone https://github.com/HackResist/Shell-X-Bot.git

2. Setup Bot: Go to bot-father to create bot and search get chat id for chat-ID.

3. Set Up Your Bot Token and Chat ID: Open the script and replace the $botToken and $chatID with your own Telegram bot token and chat ID.

4. Adjust Execution Policy: Run the following command in PowerShell to allow the script to execute: Set-ExecutionPolicy RemoteSigned -Scope Process -Force

5. Run the Script: Execute the script in your PowerShell terminal:\path-of-script\YourScriptName.ps1

🛠️ Available Commands

• /start:👋 Show Command message.

• /createfile <file_path> <content>: 📝Create a file with specified content.

• /removefile <file_path>:🗑️ Remove the specified file.

• /listfiles <Directory_path>: 📂See list of all files in the specified directory.

• /logoff:🔐 Log off the current user.

• /showmessage <content>:💬 Display a custom message in a dialog.

• /lockcomputer: 🔒 Lock the computer.

• /shutdown [delay]: ⏳Shutdown the computer, with an optional delay in second.

• /restart:🔄 Restart the computer.

• /sysinfo:💻 Get system information.

• /getcurrentdir:📁 Get the current directory where powershell script file present.

• /gethardwareinfo:🖥️ Retrieve hardware information.

• /gethistory:📝 Get command history.

• /clearhistory: 🧹 Clear command history.

• /getsystemstatus: 📊Get battery, CPU, RAM, and network status.

• /getip: 🌐Get your external IP address.

• /getdevices:🔌 Retrieve connected hardware information.

• /getopenedapplications:📋 List all opened applications.

• /getuptime: ⏱️ Get system uptime.

• /getstoragedetails: 💾Get details of connected storage.

• /getfilecontent <file_path>:📄 Retrieve the content of a specified file.

• /runfile <file_path>:🛠️ Execute a file by specifying the path (It's open file by defaault set application.

• /killprocess <process_id | application_name>:❌ Kill a running process by ID or name.

• /runprocess <exe_path> [File_path]:▶️ Run an executable file with optional arguments.

📋 Detailed Command Explanation

If you have any questions about using the commands, please refer to the command list and example file for guidance.

🤝Contribution

Contributions are welcome! If you have suggestions for improvements or additional features, feel free to fork the repository and submit a pull request.

📜License

This project is licensed under the MIT License. See the LICENSE file for more details.

📞 Support

For any queries or support, feel free to reach out via Twitter, LinkedIn, or create an issue on the GitHub repository.