Skip to content

Commit 4972a27

Browse files
DefinetlyNotAIDefinetlyNotAI
committed
Added README.md
1 parent 8ffe1cf commit 4972a27

File tree

2 files changed

+246
-67
lines changed

2 files changed

+246
-67
lines changed

‎README.md

Lines changed: 246 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,246 @@
1+
<p align="center">
2+
<img src="https://raw.githubusercontent.com/PKief/vscode-material-icon-theme/ec559a9f6bfd399b82bb44393651661b08aaf7ba/icons/folder-markdown-open.svg" align="center" width="30%" alt="md_logo">
3+
</p>
4+
<p align="center"><h1 align="center">MALWARE BUILDER</h1>
5+
<p align="center">
6+
<em><code>❯ A Python-based tool for creating and managing malware for educational purposes.</code></em>
7+
</p>
8+
<p align="center">
9+
<img src="https://img.shields.io/github/license/DefinetlyNotAI/MalwareBuilder?style=default&logo=opensourceinitiative&logoColor=white&color=0080ff" alt="license">
10+
<img src="https://img.shields.io/github/last-commit/DefinetlyNotAI/MalwareBuilder?style=default&logo=git&logoColor=white&color=0080ff" alt="last-commit">
11+
<img src="https://img.shields.io/github/languages/top/DefinetlyNotAI/MalwareBuilder?style=default&color=0080ff" alt="repo-top-language">
12+
<img src="https://img.shields.io/github/languages/count/DefinetlyNotAI/MalwareBuilder?style=default&color=0080ff" alt="repo-language-count">
13+
</p>
14+
<br>
15+
16+
## 🔗 Table of Contents
17+
18+
- [📍 Overview](#-overview)
19+
- [👾 Features](#-features)
20+
- [📁 Project Structure](#-project-structure)
21+
- [📂 Project Index](#-project-index)
22+
- [🚀 Getting Started](#-getting-started)
23+
- [☑️ Prerequisites](#-prerequisites)
24+
- [⚙️ Installation](#-installation)
25+
- [🤖 Usage](#-usage)
26+
- [📌 Project Roadmap](#-project-roadmap)
27+
- [🔰 Contributing](#-contributing)
28+
- [🎗 License](#-license)
29+
- [🙌 Acknowledgments](#-acknowledgments)
30+
31+
---
32+
33+
## 📍 Overview
34+
35+
❯ MalwareBuilder is a Python-based tool designed for educational purposes
36+
to demonstrate various malware functionalities.
37+
It includes features to disable system components, create spam accounts,
38+
and more.
39+
40+
> [!IMPORTANT]
41+
> Use responsibly and for educational purposes only.
42+
> This tool is still in BETA and may contain bugs or not work as intended. PLEASE TEST IN A VIRTUAL MACHINE.
43+
44+
---
45+
46+
## 👾 Features
47+
48+
<code>❯ The tool includes the following features:</code>
49+
50+
<details about="Features">
51+
<ul>
52+
<li>Disable Registry</li>
53+
<li>Disable MsConfig</li>
54+
<li>Disable TaskManager</li>
55+
<li>Disable Time</li>
56+
<li>Disable Group Policy</li>
57+
<li>Disable Windows Explorer</li>
58+
<li>Disable NotePad</li>
59+
<li>Create Multiple Spam Windows Accounts</li>
60+
<li>Disable Windows Firewall</li>
61+
<li>Create Multiple Spam Error Windows messages</li>
62+
<li>Disable Windows Update</li>
63+
<li>Disable Windows Defender (Not possible, but attempted)</li>
64+
<li>Create Multiple Files/Folders in Desktop</li>
65+
<li>Disable DHCP Client</li>
66+
<li>Disable Taskbar</li>
67+
<li>Disable Start Menu</li>
68+
<li>Disable CMD</li>
69+
<li>Disable Powershell (Not possible, but attempted)</li>
70+
<li>Disable Run</li>
71+
<li>Disable Control Panel</li>
72+
<li>Disable System Restore</li>
73+
<li>Destroy Desktop Icons</li>
74+
<li>Hide Windows Clock (Untested)</li>
75+
<li>Swap Mouse Buttons</li>
76+
<li>Remove Folder Options</li>
77+
<li>Disable HID Devices completely (Untested)</li>
78+
<li>Turn Off Monitor (Temporary)</li>
79+
<li>Crazy Mouse</li>
80+
<li>Crazy Taskbar</li>
81+
<li>Disable Audio Service</li>
82+
<li>Corrupt Clipboard</li>
83+
<li>Destroy Windows (Untested)</li>
84+
<li>Lock Cursor</li>
85+
<li>Auto Startup</li>
86+
<li>Move File to New location</li>
87+
<li>Crash Windows</li>
88+
<li>Bug out Windows GUI</li>
89+
<li>Teleport all windows</li>
90+
<li>Close all applications</li>
91+
</ul>
92+
</details>
93+
94+
> [!INFO]
95+
> Even when testing all features simultaneously,
96+
> the native windows antivirus did not flag the exe's as malicious.
97+
98+
---
99+
100+
## 📁 Project Structure
101+
102+
```
103+
└── MalwareBuilder/
104+
├── MalwareBuilder.py
105+
├── MalwareCode.py
106+
├── config.ini
107+
└── requirements.txt
108+
```
109+
110+
### 📂 Project Index
111+
112+
<details open>
113+
<summary><b><code>MALWARE BUILDER/</code></b></summary>
114+
<details> <!-- __root__ Submodule -->
115+
<summary><b>__root__</b></summary>
116+
<blockquote>
117+
<table>
118+
<tr>
119+
<td><b><a href='https://github.com/DefinetlyNotAI/MalwareBuilder/blob/master/MalwareBuilder.py'>MalwareBuilder.py</a></b></td>
120+
<td><code>❯ Main script to build and manage malware features.</code></td>
121+
</tr>
122+
<tr>
123+
<td><b><a href='https://github.com/DefinetlyNotAI/MalwareBuilder/blob/master/config.ini'>config.ini</a></b></td>
124+
<td><code>❯ Configuration file for selecting features.</code></td>
125+
</tr>
126+
<tr>
127+
<td><b><a href='https://github.com/DefinetlyNotAI/MalwareBuilder/blob/master/MalwareCode.py'>MalwareCode.py</a></b></td>
128+
<td><code>❯ Contains the implementation of malware features.</code></td>
129+
</tr>
130+
<tr>
131+
<td><b><a href='https://github.com/DefinetlyNotAI/MalwareBuilder/blob/master/requirements.txt'>requirements.txt</a></b></td>
132+
<td><code>❯ List of dependencies required for the project.</code></td>
133+
</tr>
134+
</table>
135+
</blockquote>
136+
</details>
137+
</details>
138+
139+
---
140+
141+
## 🚀 Getting Started
142+
143+
### ☑️ Prerequisites
144+
145+
Before getting started with MalwareBuilder, ensure your runtime environment meets the following requirements:
146+
147+
- **Programming Language:** Python
148+
- **Package Manager:** Pip
149+
- **Operating System:** Windows
150+
151+
> [!TIP]
152+
> MalwareBuilder uses `PyInstaller` to create an executable file.
153+
> `PyInstaller` may produce a VERY LARGE executable file, if run from the public version of Python.
154+
> It is recommended to use `PyInstaller` with a virtual environment to reduce the size of the executable file.
155+
> This happens because `PyInstaller` includes every library you have, which is not necessary for most applications.
156+
> In experience, Without a virtual environment, the executable file was 2.4GB each. With it, the executable file was 37MB each.
157+
158+
159+
### ⚙️ Installation
160+
161+
Install MalwareBuilder using the following method:
162+
163+
**Build from source:**
164+
165+
1. Clone the MalwareBuilder repository:
166+
167+
```sh
168+
❯ git clone https://github.com/DefinetlyNotAI/MalwareBuilder
169+
```
170+
171+
2. Navigate to the project directory:
172+
173+
```sh
174+
❯ cd MalwareBuilder
175+
```
176+
177+
3. Install the project dependencies:
178+
179+
**Using `pip`**
180+
&nbsp; [<img align="center" src="https://img.shields.io/badge/Pip-3776AB.svg?style={badge_style}&logo=pypi&logoColor=white" />](https://pypi.org/project/pip/)
181+
182+
```sh
183+
❯ pip install -r requirements.txt
184+
```
185+
186+
### 🤖 Usage
187+
188+
Run MalwareBuilder using the following command:
189+
190+
```sh
191+
❯ python MalwareBuilder.py
192+
```
193+
194+
---
195+
196+
## 🔰 Contributing
197+
198+
- **🐛 [Report Issues](https://github.com/DefinetlyNotAI/MalwareBuilder/issues)**: Submit bugs found or requests for the `MalwareBuilder` project.
199+
- **💡 [Submit Pull Requests](https://github.com/DefinetlyNotAI/MalwareBuilder/blob/main/CONTRIBUTING.md)**: Review open PRs, and submit your own PRs.
200+
201+
<details >
202+
<summary>Contributing Guidelines</summary>
203+
204+
1. **Fork the Repository**: Start by forking the project repository to your GitHub account.
205+
2. **Clone Locally**: Clone the forked repository to your local machine using a git client.
206+
```sh
207+
git clone https://github.com/DefinetlyNotAI/MalwareBuilder
208+
```
209+
3. **Create a New Branch**: Always work on a new branch, giving it a descriptive name.
210+
```sh
211+
git checkout -b new-feature-x
212+
```
213+
4. **Make Your Changes**: Develop and test your changes locally.
214+
5. **Commit Your Changes**: Commit with a clear message describing your updates.
215+
```sh
216+
git commit -m 'Implemented new feature x.'
217+
```
218+
6. **Push to GitHub**: Push the changes to your forked repository.
219+
```sh
220+
git push origin new-feature-x
221+
```
222+
7. **Submit a Pull Request**: Create a PR against the original project repository. Clearly describe the changes and
223+
their motivations.
224+
8. **Review**: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your
225+
contribution!
226+
227+
</details>
228+
229+
<details >
230+
<summary>Contributor Graph</summary>
231+
<br>
232+
<p align="left">
233+
<a href="https://github.com/DefinetlyNotAI/MalwareBuilder/graphs/contributors">
234+
<img src="https://contrib.rocks/image?repo=DefinetlyNotAI/MalwareBuilder" alt="contribs">
235+
</a>
236+
</p>
237+
</details>
238+
239+
---
240+
241+
## 🎗 License
242+
243+
This project is protected under the [MIT](https://choosealicense.com/licenses/mit/) License. For more details,
244+
refer to the [LICENSE](LICENSE) file.
245+
246+
---

‎malware todo.txt

Lines changed: 0 additions & 67 deletions
This file was deleted.

0 commit comments

Comments
 (0)