CP_Scripts2

Table of Contents

• Dependancies
• Current Scripts and GUI’s Available
• How to compile a GUI from source code
• Usage Instructions For CLI Powershell Scripts:
• Usage Instructions For Linux CLI Scripts
• Version Numbers
• FaQ

Website: https://matrix0501.com

DISCLAIMERS: This project is student made with inspiration from other projects such as the scripts made by Ethan Fowler from TEAM BYTE.

Note	This is program is Pre-Alpha so it still has many bugs and is missing many of the core features. I am only one person so this will take a while to even get to Alpha. Thank you for your understanding.

This script also uses Microsoft Sysinternals suite which is owned and created by Microsoft. I do not take any credit in the creation of that program.(I don’t want to get sued)

Before using any of these scripts for the CyberPatriot challenges, please make sure that you complete as many of the Forensic Questions as possible! If not, then you risk the chance that the script will remove or change something that the Forensics Question requires later.

---

Dependancies

• Admin access

• Set-ExecutionPolicy Unrestricted (For Powershell Scripts only)

Current Scripts and GUI’s Available

I currently have two Command Line scripts:

• Powershell Script for Windows machines

• Bash Script for Linux machines

These two scripts currently have around 10-20 commands each.They do most of the basic commands that you would use in competition, but, they are not good enough that they could get you a ton of points by just using them alone.

I currently have available three GUI’s. Of the three, only two are very developed. The following list are the available GUI’s to choose from:

• Script Runner Tkinter

  • Built on the TKinter framework so it looks like it was made in the 90’s

• Script Runner Electron

  • This GUI is built on the same framework that applications like Discord, Slack, and Atom. Although due to it using website code (HTML, CSS, JavaScript) I am still having trouble attempting to connect it to python code that will actually execute the commands

• Script Runner PyQt5

  • This GUI is built on the PyQt frame work.This is the newest best version of all of the GUI’s and Scripts Combined.It is the most modern looking and has the most commands, platform support, and Ease of Use.

How to compile a GUI from source code

Make sure you have the correct version of Pyinstaller:

pip install https://github.com/pyinstaller/pyinstaller/archive/develop.tar.gz

Run pip install auto-py-to-exe to install the compiler.

Note	For executables that work on Windows: Run auto-py-to-exe on a windows machine. For executables that work with Linux: Run auto-py-to-exe on a Linux/Unix machine.

1.) Move all files that are to be converted into a .exe onto the desktop.
2.) open powershell/terminal as admin and type auto-py-to-exe
3.) In Script Location in the newly opened window, put in the location of the .py file that launches the GUI
4.) Under Additional Files, add all folders and files that are to be used in the script
5.) Under Advanced, change Output Directory to the desktop to easily locate the newly created .exe file
6.) Hit Convert .PY TO .EXE
7.) your newly created .exe file should now have been created and added to the desktop

https://dev.to/eshleron/how-to-convert-py-to-exe-step-by-step-guide-3cfi

Usage Instructions For CLI Powershell Scripts:

1.) Run Powershell as Admin
2.) Navigate to location of script file through powershell ex: cd C:\Users\Michael\Downloads\
3.) In Powershell type the following: Set-ExecutionPolicy Unrestricted
Do this to allow the execution of Powershell scripts
4.) Once at the location where the script is located type the following: ./cyberWin10.ps1

Hit Enter

That is it! Good Luck!

Some of the commands might require for you to execute them twice if they did not show a list when they should have. I am currently working on fixing this problem.

Usage Instructions For Linux CLI Scripts

1.) Navigate to directory where script is located in terminal
2.) Type the following: sudo bash ./linux_Script.sh
3.) The script is now running and you are now free to choose the commands to execute

Version Numbers

1.2.3.4

First Number: Generation (General Information → 0, Cli → 1, Tkinter → 2, PyQt5 →3, Electron → 4)
This number is to be used to identify which generation of script has been changed. For example, if I were to change something in the CLI version it would uploaded as version 1.x.x.x, but if I were to change something in the Electron version, I would upload as version 4.x.x.x

Second Number: used for noting number of os’s completely supported in the generation

Third Number: Number of completed commands regardless of OS type or section of program (mainly used in the GUI versions).

Fourth Number: used for patches, minor updates, and updates that are working towards a new feature.
This is also updated when code has been edited to become more efficient or after finding a typo and making a quick edit. Also changes if a file was forgotten when pushing to the repository.

Note	When ever a version number has been updated, all of the numbers to the right of the changed number is set to zero.

FaQ

1. Why is it that when I download the exe, it says it is malware?

   This is because I have not yet been able to sign my executables. So as of right now, windows does not know that this program is safe so it try’s to warn you that this is not an official program.

2. Why are there so many different versions within the same repository?

   This is because when I first made the repository, I did not plan on making any of the other versions. I thought it was going to be just the CLI Script and that was it. After some time working on that I started to look into other ways of creating scripts and realized that I could also try and make things such as GUIs for it. Before I knew it, I had several versions and types of projects in one repository and have been too lazy to create a new repo for each version of the project.