+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/public/js/index.js b/public/js/index.js
new file mode 100644
index 0000000..4f954eb
--- /dev/null
+++ b/public/js/index.js
@@ -0,0 +1,97 @@
+/*
+ Project: Catherine Framework (https://github.com/azazelm3dj3d/catherine)
+ Author: azazelm3dj3d (https://github.com/azazelm3dj3d)
+ License: BSD 2-Clause
+*/
+
+const { invoke } = window.__TAURI__.tauri
+
+// Decode a string
+const decodeString = () => {
+ invoke('decode_string', {
+ methodName: document.getElementById("methodName").value,
+ encodedData: document.getElementById("encodedData").value
+ }).then((response) => {
+ document.getElementById("res_0").innerHTML = response;
+ })
+}
+
+// Dump host system information
+const sysInfo = () => {
+ invoke('sys_info').then((response) => {
+ document.getElementById("res_1").innerHTML = response;
+ })
+}
+
+// Defang a string
+const defangString = () => {
+ invoke('defang_string', {
+ defangValue: document.getElementById("defangValue").value
+ }).then((response) => {
+ document.getElementById("res_2").innerHTML = response;
+ })
+}
+
+// WHOIS url lookup
+const whoisLookup = () => {
+ invoke('whois_search', {
+ whoisUrl: document.getElementById("whoisUrl").value
+ }).then((response) => {
+ document.getElementById("res_3").innerHTML = response;
+ })
+}
+
+// Clears the WHOIS results to cleanup the UI
+const clearWhoIs = () => {
+ document.getElementById("res_3").innerHTML = "";
+}
+
+// Malicious domain search
+// const malSearch = () => {
+// invoke('malicious_search', {
+// malUrl: document.getElementById("malUrl").value
+// }).then((response) => {
+// document.getElementById("res_4").innerHTML = response;
+// })
+// }
+
+// Identify an unknown string
+const idString = () => {
+ invoke('id_string', {
+ idStr: document.getElementById("idStr").value
+ }).then((response) => {
+ document.getElementById("res_5").innerHTML = response;
+ })
+}
+
+// Attempt to crack an unknown hash
+const crackHash = () => {
+ invoke('crack_hash', {
+ hashCracker: document.getElementById("hashCracker").value
+ }).then((response) => {
+ document.getElementById("res_6").innerHTML = response;
+ })
+}
+
+// Generate a domain for DNS squatting
+const domainGen = () => {
+ invoke('domain_gen', {
+ domainStr: document.getElementById("domainStr").value
+ }).then(() => {
+ document.getElementById("res_7").innerHTML = "Check terminal";
+ })
+}
+
+// Extract a zip file contents
+const zipExtract = () => {
+ invoke('extract_zip', {
+ extractZipFile: document.getElementById("extractZipFile").value
+ }).then(() => {
+ document.getElementById("res_8").innerHTML = "Check terminal";
+ })
+}
+
+// Exit application
+const exitCatherine = () => {
+ invoke("exit_catherine")
+}
\ No newline at end of file
diff --git a/src/catherine.rs b/src/catherine.rs
index 6c0599f..42a4d8f 100644
--- a/src/catherine.rs
+++ b/src/catherine.rs
@@ -44,14 +44,16 @@ use crate::core::{
use mercy::{
mercy_decode,
mercy_extra,
- mercy_malicious, // status, url
+ mercy_malicious, mercy_experimental // status, url
};
+use crate::ui::controller::launch_gui;
+
#[cfg(target_os = "windows")]
extern crate ipconfig;
pub(crate) static NAME: &str = "Catherine";
-pub(crate) static VERSION: &str = "0.4.1";
+pub(crate) static VERSION: &str = "0.5.0";
pub(crate) static NETSCAN_PATH: &str = "/opt/catherine/modules/net/netscan/dist/netscan";
pub(crate) static LINK_PARSER_PATH: &str = "/opt/catherine/modules/web/parsers/dist/links";
@@ -161,6 +163,7 @@ pub fn init(boot_msg: &str) {
win_adapter_dump();
},
+ // NOTE: Doesn't work on macOS
"sys_info" => {
println!("{}Internal IP Address: {}\n", mercy_extra("system_info", "all"), mercy_extra("internal_ip", ""));
},
@@ -187,9 +190,42 @@ pub fn init(boot_msg: &str) {
println!("Status: {}", mercy_malicious("status", set_url));
},
+ "id" => {
+ let id: String = catherine_shell(NAME, VERSION, "identify/string".blue());
+ let id_str: &str = &id;
+
+ println!("{}", mercy_extra("identify", id_str));
+ },
+
+ "crack_hash" => {
+ let hash: String = catherine_shell(NAME, VERSION, "crack_hash/hash".blue());
+ let hash_str: &str = &hash;
+
+ println!("{}", mercy_extra("crack", hash_str));
+ },
+
+ "domain_gen" => {
+ let domain_name: String = catherine_shell(NAME, VERSION, "domain_gen/domain".blue());
+ let domain_str: &str = &domain_name;
+
+ mercy_experimental("domain_gen", domain_str);
+ },
+
+ "extract_zip" => {
+ let zip_name: String = catherine_shell(NAME, VERSION, "extract/zip".blue());
+ let zip_str: &str = &zip_name;
+
+ mercy_experimental("zip", zip_str);
+ },
+
+ // Launches the GUI
+ "launch" => {
+ launch_gui();
+ },
+
"version" => {
println!("\nCatherine Framework v{}", VERSION);
- println!("Author: azazelm3dj3d (https://github.com/azazelm3dj3d)");
+ println!("Author: azazelm3dj3d (https://github.com/azazelm3dj3d)\n");
},
// Installs custom modules
@@ -223,7 +259,7 @@ pub fn init(boot_msg: &str) {
}
},
- "help" => {
+ "help" | "h" => {
help_menu();
},
diff --git a/src/core/commands.rs b/src/core/commands.rs
index 2115e9f..85f00a6 100644
--- a/src/core/commands.rs
+++ b/src/core/commands.rs
@@ -332,7 +332,7 @@ pub fn win_adapter_dump() {
pub fn help_menu() {
println!("\n=== General ===");
- pretty_output("start_server\nscan_ports\nsearch_exploit\nset_decode\nsys_info\ndefang\nwhois\nmal_query\n", "Start a Rust server\nScan for open local ports\nSearch ExploitDB for an available exploit to review\nDecode an encoded message using one of our provided methods\nPrint local system information to stdout\nDefang a URL or IP address (prints to stdout)\nRun a domain registrar search against the WHOIS API\nRun a domain name search to validate if it's malicious (InQuest API)", "Command", "Description");
+ pretty_output("start_server\nscan_ports\nsearch_exploit\nset_decode\nsys_info\ndefang\nwhois\nmal_query\nid\ncrack_hash\ndomain_gen\nextract_zip\nlaunch\n", "Start a Rust server\nScan for open local ports\nSearch ExploitDB for an available exploit to review\nDecode an encoded message using one of our provided methods\nPrint local system information to stdout\nDefang a URL or IP address (prints to stdout)\nRun a domain registrar search against the WHOIS API\nRun a domain name search to validate if it's malicious (InQuest API)\nAttempt to identify a string's origins\nAttempt to crack an unknown hash in real-time\nGenerate a string for domain squatting or phishing assessments\nExtract zip contents that are not password protected\nLaunch a GUI built with Tauri", "Command", "Description");
println!("\n=== Module ===");
pretty_output("set_module\nview_modules", "Set one of Catherine's modules\nCurrently installed modules", "Command", "Description");
diff --git a/src/main.rs b/src/main.rs
index 34bd72e..ad0a121 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -9,6 +9,7 @@ use rand::Rng;
mod core;
mod modules;
+mod ui;
mod catherine;
mod meta;
diff --git a/src/ui/controller.rs b/src/ui/controller.rs
new file mode 100644
index 0000000..acb6c5c
--- /dev/null
+++ b/src/ui/controller.rs
@@ -0,0 +1,111 @@
+/*
+ Project: Catherine Framework (https://github.com/azazelm3dj3d/catherine)
+ Author: azazelm3dj3d (https://github.com/azazelm3dj3d)
+ License: BSD 2-Clause
+*/
+
+#![cfg_attr(
+ all(not(debug_assertions), target_os = "windows"),
+ windows_subsystem = "windows"
+)]
+
+use std::{
+ process::exit,
+ env
+};
+
+use chrono::{
+ Timelike,
+ Local
+};
+
+use mercy::{
+ mercy_decode,
+ mercy_extra,
+ mercy_experimental
+};
+
+#[tauri::command]
+fn decode_string(method_name: &str, encoded_data: &str) -> String {
+ format!("Decoded String: {}", mercy_decode(method_name, encoded_data))
+}
+
+#[tauri::command]
+fn sys_info() -> String {
+ if env::consts::OS == "linux" {
+ format!("{}Internal IP Address: {}\n", mercy_extra("system_info", "all"), mercy_extra("internal_ip", ""))
+ } else {
+ format!("Command not available on your operating system yet!")
+ }
+}
+
+#[tauri::command]
+fn defang_string(defang_value: &str) -> String {
+ format!("Defanged: {}", mercy_extra("defang", defang_value))
+}
+
+#[tauri::command]
+fn whois_search(whois_url: &str) -> String {
+ format!("WHOIS Data: \n{}", mercy_extra("whois", whois_url))
+}
+
+// Causes extreme lag. Needs to be reviewed.
+// #[tauri::command]
+// fn malicious_search(mal_url: &str) -> String {
+// format!("URL Status: {}!", mercy_malicious("status", mal_url))
+// }
+
+#[tauri::command]
+fn id_string(id_str: &str) -> String {
+ format!("Guess: {}", mercy_extra("identify", id_str))
+}
+
+#[tauri::command]
+fn crack_hash(hash_cracker: &str) -> String {
+ format!("{}", mercy_extra("crack", hash_cracker))
+}
+
+#[tauri::command]
+fn domain_gen(domain_str: &str) -> String {
+ format!("{:?}", mercy_experimental("domain_gen", domain_str))
+}
+
+#[tauri::command]
+fn extract_zip(extract_zip_file: &str) {
+ mercy_experimental("zip", extract_zip_file)
+}
+
+#[tauri::command]
+fn exit_catherine() -> String {
+ print!("\nThanks for checking out the Catherine Framework!");
+
+ let shutdown_time = Local::now();
+ let (is_pm, hour) = shutdown_time.hour12();
+
+ println!(
+ "\nCatherine Framework shutdown at {:02}:{:02}:{:02} {}\n",
+ hour,
+ shutdown_time.minute(),
+ shutdown_time.second(),
+ if is_pm { "PM" } else { "AM" }
+ );
+
+ exit(0x0100);
+}
+
+pub fn launch_gui() {
+ tauri::Builder::default()
+ .invoke_handler(tauri::generate_handler![
+ decode_string,
+ sys_info,
+ defang_string,
+ whois_search,
+ id_string,
+ crack_hash,
+ domain_gen,
+ extract_zip,
+ exit_catherine
+ ])
+ .run(tauri::generate_context!())
+ .expect("Unable to launch Catherine GUI");
+}
\ No newline at end of file
diff --git a/src/ui/mod.rs b/src/ui/mod.rs
new file mode 100644
index 0000000..22f67fa
--- /dev/null
+++ b/src/ui/mod.rs
@@ -0,0 +1,7 @@
+/*
+ Project: Catherine Framework (https://github.com/azazelm3dj3d/catherine)
+ Author: azazelm3dj3d (https://github.com/azazelm3dj3d)
+ License: BSD 2-Clause
+*/
+
+pub mod controller;
\ No newline at end of file
diff --git a/tauri.conf.json b/tauri.conf.json
new file mode 100644
index 0000000..c4bf66d
--- /dev/null
+++ b/tauri.conf.json
@@ -0,0 +1,67 @@
+{
+ "build": {
+ "beforeBuildCommand": "",
+ "beforeDevCommand": "",
+ "devPath": "public",
+ "distDir": "public",
+ "withGlobalTauri": true
+ },
+ "package": {
+ "productName": "catherine",
+ "version": "0.5.0"
+ },
+ "tauri": {
+ "allowlist": {
+ "all": false
+ },
+ "bundle": {
+ "active": true,
+ "category": "DeveloperTool",
+ "copyright": "",
+ "deb": {
+ "depends": []
+ },
+ "externalBin": [],
+ "icon": [
+ "icons/32x32.png",
+ "icons/128x128.png",
+ "icons/128x128@2x.png",
+ "icons/icon.icns",
+ "icons/icon.ico"
+ ],
+ "identifier": "com.tauri.dev",
+ "longDescription": "",
+ "macOS": {
+ "entitlements": null,
+ "exceptionDomain": "",
+ "frameworks": [],
+ "providerShortName": null,
+ "signingIdentity": null
+ },
+ "resources": [],
+ "shortDescription": "",
+ "targets": "all",
+ "windows": {
+ "certificateThumbprint": null,
+ "digestAlgorithm": "sha256",
+ "timestampUrl": ""
+ }
+ },
+ "security": {
+ "csp": null
+ },
+ "updater": {
+ "active": false
+ },
+ "windows": [
+ {
+ "fullscreen": false,
+ "height": 720,
+ "resizable": true,
+ "title": "Catherine Framework | v0.5.0",
+ "width": 1280
+ }
+ ]
+ }
+ }
+
\ No newline at end of file
+
+
+
+
+
+
+ 
+
+
+
+
+
+
+
+ + Catherine Framework +
+
+
+
+
+
+
+
+
+
+
+
+
+ Decode
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Dump System Information (Linux only)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Defang
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ WHOIS Lookup
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Identify String
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Crack Hash
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Generate a Domain
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Extract Zip File(s)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Exit Catherine
+
+
+
+
+