Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions .github/workflows/greetings.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
name: Greetings

on: [ pull_request_target, issues ]
on: [pull_request_target, issues]

permissions:
contents: read
Expand All @@ -13,12 +13,13 @@ jobs:
pull-requests: write
steps:
- name: Harden Runner
uses: step-security/harden-runner@20cf305ff2072d973412fa9b1e3a4f227bda3c76 # v2.14.0
uses: step-security/harden-runner@20cf305ff2072d973412fa9b1e3a4f227bda3c76
with:
egress-policy: audit

- uses: actions/first-interaction@1c4688942c71f71d4f5502a26ea67c331730fa4d # v3.1.0
- name: First Interaction Greeting
uses: actions/first-interaction@1c4688942c71f71d4f5502a26ea67c331730fa4d
with:
repo-token: ${{ secrets.GITHUB_TOKEN }}
issue-message: "Hi! Thanks for pointing out an issue/suggestion for the first time to Logicytics 🤗 We hope it goes as smoothly as possible."
pr-message: "Hi! Thanks for contributing for the first time to Logicytics 🤗 We hope it goes as smoothly as possible and appreciate your valuable contribution."
repo_token: ${{ secrets.GITHUB_TOKEN }}
issue_message: "Hi! Thanks for pointing out an issue/suggestion for the first time to Logicytics 🤗 We hope it goes as smoothly as possible."
pr_message: "Hi! Thanks for contributing for the first time to Logicytics 🤗 We hope it goes as smoothly as possible and appreciate your valuable contribution."
36 changes: 18 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# Logicytics: System Data Harvester 📎
# Logicytics: System Data Harvester

Logicytics is a cutting-edge tool designed to
meticulously harvest and collect a vast array of Windows system data for forensic analysis.
Crafted with Python 🐍, it's an actively developed project that is dedicated
to gathering as much sensitive data as possible and packaging it neatly into a ZIP file 📦.
Crafted with Python, it's an actively developed project that is dedicated
to gathering as much sensitive data as possible and packaging it neatly into a ZIP file.
This comprehensive guide is here to equip you with everything you need to use Logicytics effectively.

<div style="text-align:center;" align="center">
Expand All @@ -25,7 +25,7 @@ This comprehensive guide is here to equip you with everything you need to use Lo
> By using this software, you agree to the license, and agree that you hold responsibility of how you use and modify the
> code.

## 🛠️ Installation and Setup 🛠️
## Installation and Setup

To install and setup Logicytics, follow these steps:

Expand Down Expand Up @@ -78,22 +78,22 @@ To install and setup Logicytics, follow these steps:

## Step-by-Step Installation and Usage

1) Install Python 🐍
1) Install Python
If you don't have Python installed, you can download it from the <a href="https://www.python.org/downloads/">official
website</a>.
Make sure to select the option to "Add Python to PATH" during installation.

2) Install Dependencies 📦
2) Install Dependencies
Logicytics requires Python modules. You can install all the required modules by running the following command in your
terminal:
`pip install -r requirements.txt`

3) Run Logicytics 🚀
3) Run Logicytics
To run Logicytics, simply run the following command in your terminal:
<code>python Logicytics.py -h</code>
This opens a help menu.

4) Run the Program 👾
4) Run the Program
Once you have run the program, you can run the program with the following command:
`python Logicytics.py -h`
Replace the flags with the ones you want to use.
Expand All @@ -103,21 +103,21 @@ To install and setup Logicytics, follow these steps:
> Although it's really recommended to use admin, by setting debug in the config.json to true, you can bypass this
> requirement

5) Wait for magic to happen 🧙‍♀️
5) Wait for magic to happen
Logicytics will now run and gather data according to the flags you used.

6) Enjoy the gathered data 🎉
6) Enjoy the gathered data
Once the program has finished running, you can find the gathered data in the "ACCESS/DATA" folder. Both Zip and Hash
will be found there.

> [!NOTE]
> All Zips and Hashes follow a conventional naming mechanism that goes as follows
> `Logicytics_{CODE-or-MODS}_{Flag-Used}_{Date-And-Time}.zip`

7) Share the love ❤️
7) Share the love
If you like Logicytics, please consider sharing it with others or spreading the word about it.

8) Contribute to the project 👥
8) Contribute to the project
If you have an idea or want to contribute to the project, you can submit an issue or PR on
the <a href="https://github.com/DefinetlyNotAI/Logicytics">GitHub repository</a>.

Expand All @@ -130,7 +130,7 @@ Remove add and delete files, it's the safe directory where your backups, hashes,
> Watch this [video](https://www.youtube.com/watch?v=XVTBmdTQqOs) to see a real life demo of Logicytics (Although the
> tools and interface may be changed as it's an older version `2.1.1` - `2.3.3`)

## 🔧 Configuration 🔧
## Configuration

Logicytics uses a config.ini file to store configurations. The config.ini is located in the CODE directory.

Expand All @@ -144,7 +144,7 @@ It is also used to store and save settings for other programs.
> this is used to later check for corruption or bugs.
> VERSION is the version of the project, used to check and pull for updates.

## 🚀 Mods 🚀
## Mods

Mods are special files that are run with the `--modded` flag.
These files are essentially scripts that are run after the main Logicytics.py script is run
Expand Down Expand Up @@ -172,7 +172,7 @@ you can add the script to the `MODS` directory, and it will be run with the `--m
To check all the mods and how to make your own, you can check the `Logicytics.py` file and the Wiki.
Also refer to the contributing.md for more info

## 🛑 Troubleshooting 🛑
## Troubleshooting

If you are having issues, here are some troubleshooting tips:

Expand Down Expand Up @@ -222,7 +222,7 @@ found [here](https://github.com/DefinetlyNotAI/Logicytics/wiki/6-Code-tips-and-t
> Always adhere to the [coding standards](https://github.com/DefinetlyNotAI/Logicytics/wiki/7-Advanced-Coding-Standards)
> of Logicytics!

## 🌟 Conclusion 🌟
## Conclusion

Logicytics is a powerful tool that can extract a wide variety of data from a Windows system.
With its ability to extract data from various sources, Logicytics can be used for a variety of purposes,
Expand All @@ -234,13 +234,13 @@ for any Windows system administrator or forensic investigator.
> Please remember that extracting data from a system without proper authorization is illegal and unethical.
> Always obtain proper authorization before extracting any data from a system.

## ❤️ Support Me ❤️
## Support Me

Please consider buying me a coffee or sponsoring me in GitHub sponsor,
I am saving for my college funds, and I need your help!
Supporters will be placed in the Credits ❤️

### 🔗 Links
### Links

- [Project's Wiki](https://github.com/DefinetlyNotAI/Logicytics/wiki)
- [Project's Future](PLANS.md)
Expand Down
14 changes: 7 additions & 7 deletions requirements.txt
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
configobj~=5.0.9
configparser~=7.2.0
psutil~=6.1.1
psutil~=7.2.1
requests~=2.32.5
DateTime~=6.0
colorlog~=6.10.1
aiofiles~=24.1.0
aiofiles~=25.1.0
joblib~=1.5.3
numpy~=2.4.1
pathlib~=1.0.1
safetensors~=0.7.0
tqdm~=4.66.6
tqdm~=4.67.1
WMI~=1.5.1
prettytable~=3.15.1
prettytable~=3.17.0
matplotlib~=3.10.1
networkx~=3.2.1
networkx~=3.6.1
pandas~=2.3.3
cryptography~=44.0.2
scapy~=2.5.0
cryptography~=46.0.3
scapy~=2.7.0rc1
sentence-transformers~=5.2.0
Loading