Skip to content

Commit e06819f

Browse files
TheShadyRainbow4TheShadyRainbow4
committed
Add README files for PowerShell utility scripts
Added detailed README.md documentation for Asset Manager, Advanced Startup Manager, Elite Utility Main, and Hidden Settings scripts. These files provide overviews, prerequisites, installation instructions, features, technology stack, and contact information for each utility.
1 parent 8e91350 commit e06819f

4 files changed

Lines changed: 421 additions & 0 deletions

File tree

‎PowerShell-Script_Archive/Miscellaneous/Asset Manager/README.md‎

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
<a id="readme-top"></a>
2+
3+
<!-- EliteSoftware Co. LOGO -->
4+
5+
<br />
6+
<div align="center">
7+
<!-- <a href="Logo"> -->
8+
<!-- <img src="https://i.postimg.cc/85MDTcrJ/Elite-Software-LOGO-Mocup2.png" alt="Logo" width="256" height="256"> -->
9+
<!-- </a> -->
10+
</div>
11+
12+
<!-- ABOUT THE PROJECT -->
13+
14+
# 💾 About The Project <div align="center">
15+
16+
## EliteSoftware - AssetManager Pro (Web App Launcher)
17+
18+
`AssetManager Pro` is a comprehensive, self-contained asset management application launched via a PowerShell script. The script initiates a powerful, local web application, driven by a Python backend, that provides a rich user interface for tracking and managing physical and virtual assets. All application data, including a SQLite database, attachments, and backups, is stored permanently in `C:\AssetManager`.
19+
20+
This is a full-featured application designed for individuals, small businesses, or homelab enthusiasts who need a robust system to manage hardware, software, and network resources.
21+
22+
Built by: Zachary Whiteman & Google Gemini Ai.
23+
24+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
25+
26+
<!-- GETTING STARTED -->
27+
28+
# 🔰 Getting Started
29+
This launcher script performs a one-time setup and runs a persistent web application. Please review the prerequisites carefully.
30+
31+
## 🕰️ Prerequisites
32+
To run this application, you will need:
33+
34+
* **Windows Operating System.**
35+
* **PowerShell 5.1 or newer.**
36+
* **Python 3.x:** Python must be installed and added to your system's PATH.
37+
* **Python Libraries:** The script will attempt to automatically install the following required libraries using `pip`: `python-barcode`, `qrcode`, `Pillow`, and `python-nmap`.
38+
* **Nmap (for Network Discovery):** The `nmap` command-line tool must be installed and in your system's PATH. You can download it from [nmap.org](https://nmap.org/).
39+
* **Administrator Privileges:** Required for the initial one-time setup to modify the Windows `hosts` file and check for dependencies. The script will self-elevate.
40+
41+
## 💽 Installation & Execution
42+
1. **Download:** Download the `AssetManager.ps1` script file.
43+
2. **Unblock:** Right-click the file, go to Properties, and click `Unblock` if the file was downloaded from the internet.
44+
3. **Run:** Execute the script from a PowerShell console. It will perform a one-time setup if needed, then launch the web server.
45+
```powershell
46+
.\AssetManager.ps1
47+
```
48+
4. **Access:** Once the server is running, the script will automatically open the web application in your default browser at `http://asset.manager.local:8080`.
49+
50+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
51+
52+
## 🚀 Key Features
53+
54+
### Core Asset Management
55+
* **Full CRUD Operations:** Add, view, edit, and delete assets.
56+
* **Detailed Tracking:** Fields for name, category, status, purchase date, cost, manufacturer, model, serial number, location, and more.
57+
* **Check-in / Check-out:** Track who has possession of an asset.
58+
* **History & Logging:** Every check-in, check-out, and change is logged for a complete audit trail.
59+
* **Attachments:** Upload images and other files directly to an asset's record.
60+
* **Archiving:** Archive retired assets to remove them from the main view without deleting their history.
61+
62+
### Advanced Features
63+
* **Network Discovery:** Scan your local network with Nmap to discover new devices and add them as assets with one click.
64+
* **IPAM (IP Address Management):** Define subnets and track IP address assignments to your assets.
65+
* **Barcode & QR Codes:** Automatically generates unique barcodes and QR codes for every asset, perfect for printing labels.
66+
* **Kiosk & Scan Modes:** Use a dedicated interface to quickly look up assets with a barcode scanner or your device's camera.
67+
* **Logistics Management:** Includes modules for managing Software Licenses, Racks, and Vendors.
68+
* **Data Utilities:**
69+
* Import and export assets via CSV.
70+
* Create and restore full database backups.
71+
* Generate printable sheets of barcode labels for new or existing assets.
72+
* **Customization:** Use the settings page to change the UI theme, configure asset number prefixes, and set a default user for check-outs.
73+
74+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
75+
76+
## 🛠️ Technology Stack
77+
* **Launcher/Wrapper:** PowerShell
78+
* **Web Application Backend:** Python (using the built-in `http.server`).
79+
* **Database:** SQLite 3.
80+
* **Frontend:** Standard HTML, CSS, and vanilla JavaScript.
81+
* **Dependencies:** `python-barcode`, `qrcode`, `Pillow`, `python-nmap`.
82+
83+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
84+
85+
## 📐 Architecture & Security Notes
86+
* **Self-Contained Application:** All application data, including the Python script, database, and user uploads, is stored in the `C:\AssetManager` directory.
87+
* **Localhost Only:** The web server is bound to `127.0.0.1` and is intended for local access only. The script adds a `hosts` file entry (`127.0.0.1 asset.manager.local`) for a friendly URL.
88+
* **Administrator for Setup:** The script only requires administrator rights for the initial setup to check dependencies and modify the hosts file.
89+
* **Development Server:** The Python web server is for single-user, local application use and is not hardened for a production environment.
90+
91+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
92+
93+
## 🪪 License
94+
Distributed under the MIT License. See LICENSE.txt for more information.
95+
96+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
97+
98+
## ☎️ Contact
99+
Zach Whiteman - elitesoftwarecolimited@gmail.com
100+
101+
HuggingFace - https://huggingface.co/EliteSoftware
102+
103+
HuggingFace (Personal) - https://huggingface.co/TheShadyRainbow
104+
105+
LinkTree - https://linktr.ee/zachrainbow
106+
107+
Patreon - https://www.patreon.com/c/EliteSoftwareCo
108+
109+
<p align="right">(<a href="#readme-top">back to top</a>)</p>

‎PowerShell-Script_Archive/System Utilities & Management/Advanced StartupManager/README.md‎

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
<a id="readme-top"></a>
2+
3+
<!-- EliteSoftware Co. LOGO -->
4+
5+
<br />
6+
<div align="center">
7+
<!-- <a href="Logo"> -->
8+
<!-- <img src="https://i.postimg.cc/85MDTcrJ/Elite-Software-LOGO-Mocup2.png" alt="Logo" width="256" height="256"> -->
9+
<!-- </a> -->
10+
</div>
11+
12+
<!-- ABOUT THE PROJECT -->
13+
14+
# 💾 About The Project <div align="center">
15+
16+
## Advanced Startup Manager
17+
18+
The `Advanced Startup Manager` is a comprehensive PowerShell utility with a rich graphical user interface (GUI) built using WPF (Windows Presentation Foundation). It provides a centralized and powerful platform for viewing, managing, and analyzing all auto-starting applications, scheduled tasks, and system services on a Windows machine. This tool consolidates functionality from multiple system utilities (Task Manager, Task Scheduler, Services) into a single, feature-rich application.
19+
20+
Built by: Zachary Whiteman & Google Gemini Ai.
21+
22+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
23+
24+
<!-- GETTING STARTED -->
25+
26+
# 🔰 Getting Started
27+
This is an advanced system utility designed for power users and system administrators.
28+
29+
## 🕰️ Prerequisites
30+
To run this script, you will need:
31+
32+
* **Windows Operating System.**
33+
* **PowerShell 5.1 or newer.**
34+
* **.NET Framework 4.5 or later:** Required for the WPF-based GUI.
35+
* **Administrator Privileges:** The script requires administrator access for full functionality and will attempt to self-elevate if not run as an administrator.
36+
37+
## 💽 Installation & Execution
38+
1. **Download:** Download the `AdvancedStartupManager.PS1` script file.
39+
2. **Unblock:** Right-click the file, go to Properties, and click `Unblock` if the file was downloaded from the internet.
40+
3. **Run:** Execute the script from a PowerShell console or by double-clicking it. The script will automatically request administrator elevation.
41+
```powershell
42+
.\AdvancedStartupManager.PS1
43+
```
44+
45+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
46+
47+
## 🚀 Features
48+
The application is organized into three main tabs, each packed with features.
49+
50+
### Startup Apps
51+
* **Comprehensive Listing:** Displays startup items from all common locations, including multiple registry hives and system-wide startup folders.
52+
* **Modern App Support:** Correctly identifies and manages the enabled/disabled state of modern startup apps.
53+
* **Multiple Views:** View items in a detailed data grid or a more visual icon-based layout.
54+
* **Full Management:** Enable, disable, delete, or add new startup applications.
55+
* **Rich Details:** Shows application icons, publisher information, and digital signature status.
56+
57+
### Scheduled Tasks
58+
* **Complete Overview:** Lists all configured scheduled tasks on the system.
59+
* **Full Control:** Enable, disable, delete, or manually trigger any task from the list.
60+
* **Detailed Information:** Displays the task's path, state, last run time, and next run time.
61+
62+
### Services
63+
* **Service Management:** Lists all system services, similar to `services.msc`.
64+
* **Service Control:** Start, stop, or change the startup type (Automatic, Manual, Disabled) of any service.
65+
* **Detailed Tooltips:** Hover over a service to see its full description and the path to its executable.
66+
67+
### Universal Features
68+
* **Search, Sort, and Group:** Each tab features powerful controls to search, sort, and group items to quickly find what you're looking for.
69+
* **Rich Context Menus:** Right-click on an item to access a context menu with advanced options like "Open File Location," "Properties," "Verify Digital Signature," "Check on VirusTotal," and "Open in Registry Editor."
70+
* **JSON Export:** Back up the list of items from any tab to a structured JSON file.
71+
72+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
73+
74+
## 🛠️ Technology Stack
75+
* **Scripting Language:** PowerShell
76+
* **GUI Framework:** Windows Presentation Foundation (WPF).
77+
* **System Interaction:** Utilizes a combination of PowerShell cmdlets (`Get-ScheduledTask`, `Get-CimInstance`), .NET classes, and registry queries to gather and manage system information.
78+
79+
<p align="-top">back to top</a>)</p>
80+
81+
## 📐 Architecture & Security Notes
82+
* **Administrator Required:** The script's core functionality relies on having administrator privileges to read and write to protected system locations. It includes a self-elevation mechanism.
83+
* **System Modification:** This tool can make significant changes to your system's configuration (disabling services, deleting startup items, etc.). Use it with care.
84+
* **External Lookups:** The "Check on VirusTotal" feature will open your default web browser and navigate to the VirusTotal website with the file hash of the selected item.
85+
86+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
87+
88+
## 🪪 License
89+
Distributed under the MIT License. See LICENSE.txt for more information.
90+
91+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
92+
93+
## ☎️ Contact
94+
Zach Whiteman - elitesoftwarecolimited@gmail.com
95+
96+
HuggingFace - https://huggingface.co/EliteSoftware
97+
98+
HuggingFace (Personal) - https://huggingface.co/TheShadyRainbow
99+
100+
LinkTree - https://linktr.ee/zachrainbow
101+
102+
Patreon - https://www.patreon.com/c/EliteSoftwareCo
103+
104+
<p align="right">(<a href="#readme-top">back to top</a>)</p>

‎PowerShell-Script_Archive/System Utilities & Management/Elite Utility Main/README.md‎

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
<a id="readme-top"></a>
2+
3+
<!-- EliteSoftware Co. LOGO -->
4+
5+
<br />
6+
<div align="center">
7+
<!-- <a href="Logo"> -->
8+
<!-- <img src="https://i.postimg.cc/85MDTcrJ/Elite-Software-LOGO-Mocup2.png" alt="Logo" width="256" height="256"> -->
9+
<!-- </a> -->
10+
</div>
11+
12+
<!-- ABOUT THE PROJECT -->
13+
14+
# 💾 About The Project <div align="center">
15+
16+
## EliteUtility - Main
17+
18+
`EliteUtility - Main` is a PowerShell script that serves as the main application shell for a modular suite of system utilities. It provides a flexible framework with a navigation tree on the left and a content area on the right, designed to load various "snap-in" panels, each offering a distinct piece of functionality.
19+
20+
This version is a work-in-progress, with some modules fully implemented (like the AI Assistant) and others acting as placeholders for future development.
21+
22+
Built by: Zachary Whiteman & Google Gemini Ai.
23+
24+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
25+
26+
<!-- GETTING STARTED -->
27+
28+
# 🔰 Getting Started
29+
This script is the central hub for the EliteUtility suite and has several external dependencies for full functionality.
30+
31+
## 🕰️ Prerequisites
32+
To run this script and use its features, you will need:
33+
34+
* **Windows Operating System.**
35+
* **PowerShell 5.1 or newer.**
36+
* **.NET Framework:** Required for the Windows Forms GUI.
37+
* **Local AI Server (for AI Assistant):** Requires a local, OpenAI-compatible API endpoint running at `http://192.168.10.100:1234`. This is typically provided by applications like LM Studio.
38+
* **`wingetsearch.ps1` (for Package Manager):** This external script must be located at `H:\Zachary Whiteman\Desktop\EliteUtility\wingetsearch.ps1` for the Package Manager snap-in to work.
39+
40+
## 💽 Installation & Execution
41+
1. **Download:** Download the `EliteUtility-Main.ps1` script file.
42+
2. **Unblock:** Right-click the file, go to Properties, and click `Unblock` if it was downloaded from the internet.
43+
3. **Run:** Execute the script from a PowerShell console.
44+
```powershell
45+
.\EliteUtility-Main.ps1
46+
```
47+
48+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
49+
50+
## 🚀 Usage & Implemented Modules
51+
Navigate the various utility modules using the tree view on the left. The corresponding tool will appear in the panel on the right.
52+
53+
### Fully Implemented Modules
54+
* **AI Assistant:**
55+
* A complete chat interface for interacting with a local AI model.
56+
* Select the desired model from the dropdown list.
57+
* Type your prompt in the input box and press **Send** or `Enter`.
58+
* The conversation is displayed in the main output window.
59+
* **Package Manager:**
60+
* A launcher panel that opens the `wingetsearch.ps1` GUI in a separate window.
61+
62+
### Placeholder Modules
63+
The following modules are part of the UI but are currently placeholders for future implementation:
64+
* Home DashBoard
65+
* DLL Icon Extractor
66+
* AI Icon Organizer
67+
* Startup Apps Manager
68+
* Services Manager
69+
70+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
71+
72+
## ✨ Key Features
73+
* **Modular Snap-in Architecture:** A flexible design that allows for adding new tools as self-contained panels.
74+
* **Tree View Navigation:** Provides a clean and organized way to switch between different utilities.
75+
* **Integrated AI Chat:** A built-in client for connecting to a local large language model.
76+
* **External Tool Integration:** Capable of launching other scripts and tools, as seen with the Package Manager snap-in.
77+
* **Work-in-Progress Framework:** A solid foundation for building a comprehensive suite of system utilities.
78+
79+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
80+
81+
## 🛠️ Technology Stack
82+
* **Scripting Language:** PowerShell
83+
* **GUI Framework:** .NET Windows Forms (WinForms).
84+
* **API Communication:** Uses `Invoke-RestMethod` to communicate with the local AI server's REST API.
85+
86+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
87+
88+
## 📐 Architecture & Security Notes
89+
* **Hardcoded Paths:** This script contains hardcoded paths to external dependencies (the `wingetsearch.ps1` script) and network endpoints (the AI server). These must be in place for the features to work.
90+
* **Network Access:** The AI Assistant feature makes network requests to a local IP address. Ensure your firewall permits this if necessary.
91+
* **Administrator Privileges:** While the main shell does not check for administrator rights, many of the intended snap-in modules (like a Services Manager or Package Manager) would require them to function correctly.
92+
93+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
94+
95+
## 🪪 License
96+
Distributed under the MIT License. See LICENSE.txt for more information.
97+
98+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
99+
100+
## ☎️ Contact
101+
Zach Whiteman - elitesoftwarecolimited@gmail.com
102+
103+
HuggingFace - https://huggingface.co/EliteSoftware
104+
105+
HuggingFace (Personal) - https://huggingface.co/TheShadyRainbow
106+
107+
LinkTree - https://linktr.ee/zachrainbow
108+
109+
Patreon - https://www.patreon.com/c/EliteSoftwareCo
110+
111+
<p align="right">(<a href="#readme-top">back to top</a>)</p>

0 commit comments

Comments
 (0)