-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit 0151b95
Showing
32 changed files
with
3,673 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| MIT License | ||
|
|
||
| Copyright (c) 2024 Lokesh Chauhan | ||
|
|
||
| Permission is hereby granted, free of charge, to any person obtaining a copy | ||
| of this software and associated documentation files (the "Software"), to deal | ||
| in the Software without restriction, including without limitation the rights | ||
| to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
| copies of the Software, and to permit persons to whom the Software is | ||
| furnished to do so, subject to the following conditions: | ||
|
|
||
| The above copyright notice and this permission notice shall be included in all | ||
| copies or substantial portions of the Software. | ||
|
|
||
| THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
| IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
| FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
| AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
| LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
| OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
| SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,157 @@ | ||
| # Shell-X-Bot🤖 | ||
|
|
||
| ## You can read in: | ||
| <p align="center"> | ||
| <a href="/docs/lang/readme_de.md">Deutsch</a> | ||
| | | ||
| <a href="/docs/lang/readme_es.md">Español</a> | ||
| | | ||
| <a href="/docs/lang/readme_fr-FR.md">Français </a> | ||
| | | ||
| <a href="/docs/lang/readme_hi-IN.md">हिंदी</a> | ||
| | | ||
| <a href="/docs/lang/readme_id.md">Bahasa Indonesia</a> | ||
| | | ||
| <a href="/docs/lang/readme_it.md">Italiano</a> | ||
| | | ||
| <a href="/docs/lang/readme_ja.md">日本語</a> | ||
| | | ||
| <a href="/docs/lang/readme_kr.md">한국어</a> | ||
| | | ||
| <a href="/docs/lang/readme_ne-NP.md">नेपाली</a> | ||
| | | ||
| <a href="/docs/lang/readme_nl-NL.md">Nederlands</a> | ||
| | | ||
| <a href="/docs/lang/readme_pt.md">Português</a> | ||
| | | ||
| <a href="/docs/lang/readme_ru.md">Русский</a> | ||
| | | ||
| <a href="/docs/lang/readme_th.md">ไทย</a> | ||
| | | ||
| <a href="/docs/lang/readme_zh.md">中文</a> | ||
|
|
||
|
|
||
| </p> | ||
| <p align="center"> | ||
| <p1>These translations are generated by the system, so they may be inaccurate. Please prefer the English documentation for better understanding.</p1> | ||
| </p> | ||
| ## 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](/docs/command/command_en.md) 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](LICENSE) file for more details. | ||
|
|
||
| ## 📞 Support | ||
|
|
||
| For any queries or support, feel free to reach out via **[Twitter](https://x.com/dev_lokesh_)**, **[LinkedIn](https://www.linkedin.com/in/lokeshchauhanapex/)**, or create an issue on the GitHub repository. | ||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
Oops, something went wrong.