manageos 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +142 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
# ManageOS
|
|
2
|
+
|
|
3
|
+
**ManageOS** is a Node.js library that provides a set of tools to manage operating system resources and settings on Windows systems. It offers utilities for registry editing, process management, file system operations, system information retrieval, and user account management.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 📦 Installation
|
|
8
|
+
|
|
9
|
+
Install via npm:
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install manageos
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
or with Yarn:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
yarn add manageos
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 🛠 Usage
|
|
24
|
+
|
|
25
|
+
### Import the package
|
|
26
|
+
|
|
27
|
+
```ts
|
|
28
|
+
import ManageOS from "manageos";
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
### File System
|
|
34
|
+
|
|
35
|
+
```ts
|
|
36
|
+
// Synchronous usage
|
|
37
|
+
const files = ManageOS.FileSystem.sync.listDirectory("C:\\Path\\To\\Folder");
|
|
38
|
+
|
|
39
|
+
// Asynchronous usage
|
|
40
|
+
const filesAsync = await ManageOS.FileSystem.async.listDirectory(
|
|
41
|
+
"C:\\Path\\To\\Folder"
|
|
42
|
+
);
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
### Registry Editor
|
|
48
|
+
|
|
49
|
+
```ts
|
|
50
|
+
await ManageOS.Regedit.createKey("HKCU\\Software\\MyApp");
|
|
51
|
+
await ManageOS.Regedit.setValue(
|
|
52
|
+
"HKCU\\Software\\MyApp",
|
|
53
|
+
"TestValue",
|
|
54
|
+
"REG_SZ",
|
|
55
|
+
"Hello World"
|
|
56
|
+
);
|
|
57
|
+
const registryData = await ManageOS.Regedit.listKey("HKCU\\Software\\MyApp");
|
|
58
|
+
await ManageOS.Regedit.deleteKey("HKCU\\Software\\MyApp");
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
### Process Manager
|
|
64
|
+
|
|
65
|
+
```ts
|
|
66
|
+
const processes = ManageOS.Taskmgr.sync.listProcesses();
|
|
67
|
+
const processCount = ManageOS.Taskmgr.sync.getProcessCount();
|
|
68
|
+
|
|
69
|
+
ManageOS.Taskmgr.sync.killByName("notepad.exe", true);
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
### System Information
|
|
75
|
+
|
|
76
|
+
```ts
|
|
77
|
+
const sysInfo = ManageOS.SystemInfo();
|
|
78
|
+
console.log(sysInfo.platform, sysInfo.architecture, sysInfo.cpus);
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
### User Management
|
|
84
|
+
|
|
85
|
+
```ts
|
|
86
|
+
const users = ManageOS.UserManager.listUsers();
|
|
87
|
+
const userInfo = ManageOS.UserManager.getUserInfo("Administrator");
|
|
88
|
+
|
|
89
|
+
ManageOS.UserManager.createUser("newuser", "password123");
|
|
90
|
+
ManageOS.UserManager.deleteUser("newuser");
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 📚 API Overview
|
|
96
|
+
|
|
97
|
+
- **`ManageOS.FileSystem`** – File and directory operations (sync & async versions).
|
|
98
|
+
- **`ManageOS.Regedit`** – Create, delete, read, and modify Windows Registry keys and values.
|
|
99
|
+
- **`ManageOS.Taskmgr`** – Process listing, monitoring, and termination.
|
|
100
|
+
- **`ManageOS.SystemInfo`** – Retrieve system details such as OS version, CPU info, memory, and uptime.
|
|
101
|
+
- **`ManageOS.UserManager`** – Manage Windows user accounts and groups.
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## ⚙ Requirements
|
|
106
|
+
|
|
107
|
+
- Node.js v18 or higher
|
|
108
|
+
- Windows operating system (registry and process management are Windows-specific)
|
|
109
|
+
- Administrative privileges for some operations
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 💡 Notes
|
|
114
|
+
|
|
115
|
+
- Many operations require elevated privileges (Administrator mode).
|
|
116
|
+
- Registry changes can affect system stability. Use with caution.
|
|
117
|
+
- This library wraps built-in Windows commands, so all outputs depend on system configuration.
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## 🔧 Development
|
|
122
|
+
|
|
123
|
+
Clone the repository and install dependencies:
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
git clone https://github.com/yourusername/manageos.git
|
|
127
|
+
cd manageos
|
|
128
|
+
npm install
|
|
129
|
+
npm run build
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
Run in development mode:
|
|
133
|
+
|
|
134
|
+
```bash
|
|
135
|
+
npm run dev
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 📄 License
|
|
141
|
+
|
|
142
|
+
MIT License © Tiziano Tomas Luzi Ramos
|