Skip to content

Commit 94c5fe7

Browse files
author
0xGrayy
authored
Merge pull request 0xGrayy#1 from RlxChap2/main
new Update & fixing some git issues
2 parents 913bfbc + 39d0eb2 commit 94c5fe7

File tree

8 files changed

+516
-248
lines changed

8 files changed

+516
-248
lines changed

‎.gitignore‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
node_modules/
2+
engines.dat
3+
dist/
4+
.env

‎CHANGELOG.md‎

Whitespace-only changes.

‎README.md‎

Lines changed: 211 additions & 104 deletions
Original file line numberDiff line numberDiff line change
@@ -1,104 +1,211 @@
1-
# 🕵️♂️ Malware Sniffer · [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
2-
3-
_A cybersecurity companion that sniffs out suspicious URLs with style_ 🔍✨
4-
5-
<div align="center">
6-
<img src="./assets/demo.gif" alt="Animated demo showing scanning process" width="800">
7-
<p><em>Watch Malware Sniffer in action – from scanning to detailed report</em></p>
8-
</div>
9-
10-
## 🌟 Why Malware Sniffer?
11-
12-
In today's digital jungle, every click matters. Malware Sniffer is your trusty sidekick that:
13-
14-
✅ **Instant Safety Check**: Scan any URL against 70+ security engines in real-time
15-
✅ **Beautiful Reports**: Get clear, color-coded results with emoji storytelling
16-
✅ **Developer Friendly**: Perfect for integrating into your security workflows
17-
✅ **Zero Hassle**: Set up in 2 minutes with automatic progress tracking
18-
19-
## 🚀 Getting Started
20-
21-
### 📦 Installation
22-
23-
```bash
24-
git clone https://github.com/0xGrayy/malwareSniffer.git
25-
cd malwareSniffer
26-
npm install
27-
```
28-
29-
### 🔐 Configuration
30-
31-
1. Get your free API key from [VirusTotal](https://www.virustotal.com)
32-
2. Create `.env` file:
33-
34-
```env
35-
VIRUSTOTAL_API_KEY=your_actual_key_here
36-
```
37-
38-
### 🕹️ Quick Start
39-
40-
```typescript
41-
import { scanUrl } from "./virusTotal";
42-
43-
// Be the cybersecurity hero your app needs 🦸
44-
scanUrl("https://your-url-here.com");
45-
```
46-
47-
## 📊 What You'll See
48-
49-
![Sample Scan Output](./assets/image-2.png)
50-
_Real scan results showing safety breakdown and detection details_
51-
52-
## 🛠️ Tech Stack
53-
54-
- **`axios`** → Smooth API communication
55-
- **`chalk`** → Terminal colors
56-
- **`cli-progress`** → That satisfying progress bar
57-
- **`figlet`** → Fancy ASCII art headers
58-
- **`moment`** → Precision timing metrics
59-
60-
## 🖌️ Feature Highlights
61-
62-
### 🎨 Visual Progress Tracking
63-
64-
![Progress Bar Demo](./assets/image-1.png)
65-
_Watch the scan unfold with live ETA updates_
66-
67-
### 🔍 Deep Analysis
68-
69-
```markdown
70-
📌 Google Safebrowsing → 🛑 Malicious (blacklist)
71-
📌 CRDF → ⚠️ Suspicious (heuristic)
72-
📌 Quttera → ✅ Harmless (signature)
73-
```
74-
75-
### 📈 Safety at a Glance
76-
77-
```
78-
Safety Score: 92% 🟩🟩🟩🟩🟩🟩🟩🟩🟩🟥
79-
```
80-
81-
## 🤝 Join the Security Squad
82-
83-
We welcome contributors! Here's how to help:
84-
85-
1. 🐛 **Report bugs** – Help us squash them!
86-
2. 💡 **Suggest features** – What's missing?
87-
3. 📖 **Improve docs** – Make things clearer
88-
4. 🧪 **Write tests** – Keep things reliable
89-
90-
**First time contributing?** Check our [contribution guide](CONTRIBUTING.md)!
91-
92-
## ⚠️ Important Notes
93-
94-
- This tool **doesn't guarantee 100% safety** – always practice defense-in-depth
95-
- API rate limits apply – be kind to VirusTotal's servers
96-
- Keep your API key secret – treat it like your WiFi password 🔑
97-
98-
## 📜 License
99-
100-
MIT Licensed - Go build something secure! 🛡️
101-
102-
---
103-
104-
Made with ❤️ by [0xGrayy] · [Report Issue](https://github.com/0xGrayy/malwareSniffer/issues)
1+
<<<<<<< HEAD
2+
# 🕵️♂️ Malware Sniffer · [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
3+
4+
_A cybersecurity companion that sniffs out suspicious URLs with style_ 🔍✨
5+
6+
<div align="center">
7+
<img src="./assets/demo.gif" alt="Animated demo showing scanning process" width="800">
8+
<p><em>Watch Malware Sniffer in action – from scanning to detailed report</em></p>
9+
</div>
10+
11+
## 🌟 Why Malware Sniffer?
12+
13+
In today's digital jungle, every click matters. Malware Sniffer is your trusty sidekick that:
14+
15+
✅ **Instant Safety Check**: Scan any URL against 70+ security engines in real-time
16+
✅ **Beautiful Reports**: Get clear, color-coded results with emoji storytelling
17+
✅ **Developer Friendly**: Perfect for integrating into your security workflows
18+
✅ **Zero Hassle**: Set up in 2 minutes with automatic progress tracking
19+
20+
## 🚀 Getting Started
21+
22+
### 📦 Installation
23+
24+
```bash
25+
git clone https://github.com/0xGrayy/malwareSniffer.git
26+
cd malwareSniffer
27+
npm install
28+
```
29+
30+
### 🔐 Configuration
31+
32+
1. Get your free API key from [VirusTotal](https://www.virustotal.com)
33+
2. Create `.env` file:
34+
35+
```env
36+
VIRUSTOTAL_API_KEY=your_actual_key_here
37+
```
38+
39+
### 🕹️ Quick Start
40+
41+
```typescript
42+
import { scanUrl } from "./virusTotal";
43+
44+
// Be the cybersecurity hero your app needs 🦸
45+
scanUrl("https://your-url-here.com");
46+
```
47+
48+
## 📊 What You'll See
49+
50+
![Sample Scan Output](./assets/image-2.png)
51+
_Real scan results showing safety breakdown and detection details_
52+
53+
## 🛠️ Tech Stack
54+
55+
- **`axios`** → Smooth API communication
56+
- **`chalk`** → Terminal colors
57+
- **`cli-progress`** → That satisfying progress bar
58+
- **`figlet`** → Fancy ASCII art headers
59+
- **`moment`** → Precision timing metrics
60+
61+
## 🖌️ Feature Highlights
62+
63+
### 🎨 Visual Progress Tracking
64+
65+
![Progress Bar Demo](./assets/image-1.png)
66+
_Watch the scan unfold with live ETA updates_
67+
68+
### 🔍 Deep Analysis
69+
70+
```markdown
71+
📌 Google Safebrowsing → 🛑 Malicious (blacklist)
72+
📌 CRDF → ⚠️ Suspicious (heuristic)
73+
📌 Quttera → ✅ Harmless (signature)
74+
```
75+
76+
### 📈 Safety at a Glance
77+
78+
```
79+
Safety Score: 92% 🟩🟩🟩🟩🟩🟩🟩🟩🟩🟥
80+
```
81+
82+
## 🤝 Join the Security Squad
83+
84+
We welcome contributors! Here's how to help:
85+
86+
1. 🐛 **Report bugs** – Help us squash them!
87+
2. 💡 **Suggest features** – What's missing?
88+
3. 📖 **Improve docs** – Make things clearer
89+
4. 🧪 **Write tests** – Keep things reliable
90+
91+
**First time contributing?** Check our [contribution guide](CONTRIBUTING.md)!
92+
93+
## ⚠️ Important Notes
94+
95+
- This tool **doesn't guarantee 100% safety** – always practice defense-in-depth
96+
- API rate limits apply – be kind to VirusTotal's servers
97+
- Keep your API key secret – treat it like your WiFi password 🔑
98+
99+
## 📜 License
100+
101+
MIT Licensed - Go build something secure! 🛡️
102+
103+
---
104+
105+
Made with ❤️ by [0xGrayy] · [Report Issue](https://github.com/0xGrayy/malwareSniffer/issues)
106+
=======
107+
# 🕵️♂️ Malware Sniffer · [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
108+
109+
_A cybersecurity companion that sniffs out suspicious URLs with style_ 🔍✨
110+
111+
<div align="center">
112+
<img src="./assets/demo.gif" alt="Animated demo showing scanning process" width="800">
113+
<p><em>Watch Malware Sniffer in action – from scanning to detailed report</em></p>
114+
</div>
115+
116+
## 🌟 Why Malware Sniffer?
117+
118+
In today's digital jungle, every click matters. Malware Sniffer is your trusty sidekick that:
119+
120+
✅ **Instant Safety Check**: Scan any URL against 70+ security engines in real-time
121+
✅ **Beautiful Reports**: Get clear, color-coded results with emoji storytelling
122+
✅ **Developer Friendly**: Perfect for integrating into your security workflows
123+
✅ **Zero Hassle**: Set up in 2 minutes with automatic progress tracking
124+
125+
## 🚀 Getting Started
126+
127+
### 📦 Installation
128+
129+
```bash
130+
git clone https://github.com/0xGrayy/malwareSniffer.git
131+
cd malwareSniffer
132+
npm install
133+
```
134+
135+
### 🔐 Configuration
136+
137+
1. Get your free API key from [VirusTotal](https://www.virustotal.com)
138+
2. Create `.env` file:
139+
140+
```env
141+
VIRUSTOTAL_API_KEY=your_actual_key_here
142+
```
143+
144+
### 🕹️ Quick Start
145+
146+
```typescript
147+
import { scanUrl } from "./virusTotal";
148+
149+
// Be the cybersecurity hero your app needs 🦸
150+
scanUrl("https://your-url-here.com");
151+
```
152+
153+
## 📊 What You'll See
154+
155+
![Sample Scan Output](./assets/image-2.png)
156+
_Real scan results showing safety breakdown and detection details_
157+
158+
## 🛠️ Tech Stack
159+
160+
- **`axios`** → Smooth API communication
161+
- **`chalk`** → Terminal colors
162+
- **`cli-progress`** → That satisfying progress bar
163+
- **`figlet`** → Fancy ASCII art headers
164+
- **`moment`** → Precision timing metrics
165+
166+
## 🖌️ Feature Highlights
167+
168+
### 🎨 Visual Progress Tracking
169+
170+
![Progress Bar Demo](./assets/image-1.png)
171+
_Watch the scan unfold with live ETA updates_
172+
173+
### 🔍 Deep Analysis
174+
175+
```markdown
176+
📌 Google Safebrowsing → 🛑 Malicious (blacklist)
177+
📌 CRDF → ⚠️ Suspicious (heuristic)
178+
📌 Quttera → ✅ Harmless (signature)
179+
```
180+
181+
### 📈 Safety at a Glance
182+
183+
```
184+
Safety Score: 92% 🟩🟩🟩🟩🟩🟩🟩🟩🟩🟥
185+
```
186+
187+
## 🤝 Join the Security Squad
188+
189+
We welcome contributors! Here's how to help:
190+
191+
1. 🐛 **Report bugs** – Help us squash them!
192+
2. 💡 **Suggest features** – What's missing?
193+
3. 📖 **Improve docs** – Make things clearer
194+
4. 🧪 **Write tests** – Keep things reliable
195+
196+
**First time contributing?** Check our [contribution guide](CONTRIBUTING.md)!
197+
198+
## ⚠️ Important Notes
199+
200+
- This tool **doesn't guarantee 100% safety** – always practice defense-in-depth
201+
- API rate limits apply – be kind to VirusTotal's servers
202+
- Keep your API key secret – treat it like your WiFi password 🔑
203+
204+
## 📜 License
205+
206+
MIT Licensed - Go build something secure! 🛡️
207+
208+
---
209+
210+
Made with ❤️ by [0xGrayy] · [Report Issue](https://github.com/0xGrayy/malwareSniffer/issues)
211+
>>>>>>> 913bfbc0c48e5bdbb30449cbd1df4b0c0c1ecd09

‎package.json‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,9 @@
77
"build": "npx tsc",
88
"start": "node dist/index.js",
99
"autobuild": "npx tsc -w",
10-
"autostart": "cls && npx tsc && node dist/index.js"
10+
"autostart": "cls && npx tsc && node dist/index.js",
11+
"push": "git add . && git commit -m \"V1.1.5\" && git push",
12+
"changelog": "git log --pretty=format:\"1. [**%s - `%h`**](https://github.com/0xGrayy/malwareSniffer/commit/%H)\" > CHANGELOG.md"
1113
},
1214
"keywords": [],
1315
"author": "",

‎src/global.d.ts‎

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,7 @@
1-
declare module "cli-progress";
2-
declare module "figlet";
1+
<<<<<<< HEAD
2+
declare module "cli-progress";
3+
declare module "figlet";
4+
=======
5+
declare module "cli-progress";
6+
declare module "figlet";
7+
>>>>>>> 913bfbc0c48e5bdbb30449cbd1df4b0c0c1ecd09

‎src/index.ts‎

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,11 @@
1-
import { scanUrl } from "./virusTotal";
2-
3-
// Example: Scan a URL
4-
scanUrl("https://youtube.com/");
1+
<<<<<<< HEAD
2+
import { scanUrl } from "./virusTotal";
3+
4+
// Example: Scan a URL
5+
scanUrl("https://youtube.com/");
6+
=======
7+
import { scanUrl } from "./virusTotal";
8+
9+
// Example: Scan a URL
10+
scanUrl("https://youtube.com/");
11+
>>>>>>> 913bfbc0c48e5bdbb30449cbd1df4b0c0c1ecd09

0 commit comments

Comments
 (0)