Skip to content

Commit 1a69be4

Browse files
committed
doc: add new banner image and update instructions with new commands
1 parent b5c893d commit 1a69be4

File tree

2 files changed

+33
-17
lines changed

2 files changed

+33
-17
lines changed

README.md

+33-17
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,11 @@
11
# Your Daily Dose of Malware
22
Tool to Harvest Fresh Malware Samples for Security Research.
3+
<div align="center">
4+
<p>
5+
<a href="#"><img src="readme_media\daily_dose_malware.webp" width="800" height="340" alt="aba-run help image" /></a>
6+
</p>
7+
8+
</div>
39

410
[![Super-Linter](https://github.com/Anti-Malware-Alliance/your-daily-dose-malware/actions/workflows/pre-commit-actions.yml/badge.svg)](https://github.com/marketplace/actions/super-linter)
511

@@ -25,39 +31,49 @@ For this a recurrently refreshed Dataset is needed. Most Research on this topic
2531
cd your-daily-dose-malware/
2632
```
2733

28-
3. **Create a virtual environment:**
29-
```bash
30-
python3 -m venv daily-dose
31-
or
32-
python -m venv daily-dose
33-
```
34-
35-
4. **Activate the virtual environment:**
34+
3. **Activate the virtual environment:**
3635
```bash
3736
poetry shell
3837
```
3938

40-
5. **Install dependencies:**
39+
4. **Install dependencies:**
4140
```bash
4241
poetry install
4342
```
4443

44+
# OSINT Sources supported
45+
46+
We gathering malwares samples from multiple osint sources and we currently support bellow source
47+
48+
- [Malshare](https://malshare.com/)
49+
- [MalwareBazaar](https://bazaar.abuse.ch/)
50+
51+
we are working to add many mores support to provides mores samples
52+
4553
# Using CLI Interface
46-
If you want to download fresh malware samples uploaded since 48 hours
54+
- `dd-run:`(stand for `daily-dose run`) is the base command means all other commands that will be introduce bellow are sub-commands and should always be preceded by `dd-run`.
55+
56+
base on the osint source you want to get samples from, you have different subcommands.
57+
58+
## malshare
59+
malshare subcommand will fetching around ten thousand and more samples you can set a treshold with `--limit` option. if this option is not provided all available samples will be download
60+
4761
```bash
48-
cd your-daily-dose-malware/
49-
python main.py -s256
62+
dd-run malshare --limit 10
63+
```
64+
if you want to define where to download your samples use `--path` followed by the path wanted. by default your malwares will be downloaded in the current directory inside al folder named: `Downloaded-Malwares`
65+
5066

67+
```bash
68+
dd-run malshare --limit 10 --path "My-daily-dose"
5169
```
52-
this could be an amount of 300 samples or more.
5370

54-
But if you're not that hungry, maybe 100 samples will satisfy your hunger.
71+
## malware bazaar
72+
malware bazaar subcommand, will fetching either `one hundred samples` or the `most_recent` you can choose which one you want to use basesd on your hungry level, by providing `--hundred` or `-h` to get the latest one hundred samples or `--most-recent` or `-mr` to get the most recent samples.
5573

5674
```bash
57-
cd your-daily-dose-malware/
58-
python main.py -hr
75+
dd-run m-bazaar --hundred
5976
```
60-
this will always download 100 samples. uploaded since 1 hour.
6177

6278
# Solution
6379

readme_media/daily_dose_malware.webp

349 KB
Binary file not shown.

0 commit comments

Comments
 (0)