automatic import of python-enhanced-psexec

3 files changed, 1143 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..c2a124a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/Enhanced%20PsExec-0.6.8.tar.gz
diff --git a/python-enhanced-psexec.spec b/python-enhanced-psexec.spec
new file mode 100644
index 0000000..a1ac0fe
--- /dev/null
+++ b/python-enhanced-psexec.spec
@@ -0,0 +1,1141 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-Enhanced-PsExec
+Version:	0.6.8
+Release:	1
+Summary:	Perform miscellaneous operations on A remote computer with Enhanced PsExec
+License:	MIT License
+URL:		https://github.com/orishamir/
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/a0/0a/4186f8482e9c24b7311b5098b749af48a34710ffb12dc698e2e6b73ae086/Enhanced%20PsExec-0.6.8.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-colorama
+
+%description
+#### !!!!!!!!!! Use "help(PsPc)" This will show you the available methods. (This usage form will contain it, but it is yet to be completed.) !!!!!!!!!!
+
+### About
+epsexec (Enhanced psexec) uses [Microsoft's Sysinternals PsExec](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec) utility that uses SMB to execute programs on remote systems.
+PsExec is a light-weight telnet replacement.    
+If you find any bugs, PLEASE report to ***`EpsexecNoReply@gmail.com`***   
+
+### Installation
+Run the following to install:   
+```
+pip install Enhanced-PsExec
+```
+
+# Requirements
+**Attacker Machine:**   
+1) You MUST have [psexec install](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec)ed   
+   **If you have A 32-bit installation, install psexec to `C:\windows\sysWOW64`.**   
+   Else, to `C:\windows\system32`   
+   **Recommended:**   
+   *The `PsPc` class has a static method `download_psexec` that can automate the process for you.*   
+   *Run: `PsPc.download_psexec()`*    
+2) You MUST run python as administrator (Ctrl+Esc, type "python", Ctrl+Shift+Enter,Alt-Y).
+
+**The Remote PC:**   
+The remote pc (The pc that you are attacking) have very few requirements;
+1) SMBv2 needs to be up and running on the Windows port. Run this CMD script on the remote computer:
+`powershell.exe Set-SmbServerConfiguration -EnableSMB2Protocol $true`
+2) The ADMIN$ share to be enabled with read/write access of the user configured.   
+   Unless the machine already has an administrator user with password, I recommend making Another user that is administrator.   
+   CMD:   
+`net user /add usernameToHack passToBeUsed`   
+To enable administrator:   
+`net localgroup administrators usernameToHack /add`    
+
+3) You'll need to add A registry key.   
+This is because UAC is set up to deny connections like this, so you will get an `ACCESS_IS_DENIED` error when attempting to connect.   
+Fix: run CMD as administrator and run:   
+`reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\system /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f`   
+
+4) RECOMMENDED: Disable firewall on the remote machine.   
+This will allow for a faster experience while connecting.   
+There is also A method to do this, so you dont need to go to the remote PC NOW.   
+you can do it remotely using: `pc.firewallChange(state="rule")`   
+Or, run on this on the remote machine in administrator CMD:   
+`netsh advfirewall firewall set rule name="File and Printer Sharing (SMB-In)" dir=in new enable=Yes`   
+Or, you can just disable the firewall entirely administrator CMD:   
+`netsh advfirewall set allprofiles state off`
+
+5) Restart the system.   
+
+## Import
+To import the package, use `from epsexec import PsPc`.   
+
+# Usage
+1) Create a PsPc class instance.   
+```python
+pc1 = PsPc(ip="IPv4", username="username", password="password")   
+```
+Or, if you want to import from a file:
+```python
+pc1 = PsPc(file="name_of_file.txt")
+```
+General settings:   
+
+**`delay_before`** --- This pauses the operation {delay_before} millisecond before starting the operation.  (Default 100)   
+**`run_as_admin`**  --- If true, it will run the operation in administrative privileges. (default True)   
+
+## firewallChange
+This is probably the most important method. why?   
+Well, because firewall makes the psexec process extremely slow (It takes about 12 seconds instead of 1).   
+So, it becomes very frustrating.   
+Modes:
+1. "on" to enable firewall on the remote machine.
+2. "off" to disable firewall on the remote machine.
+3. "smb" to add a SMB-only rule. This will allow connections from port 445 (smb)
+4. "rdp" to add a remote desktop rule to make connections from remote desktop easier.  
+
+## download_nir
+[NirCMD](https://www.nirsoft.net/utils/nircmd.html) is A windows command-line utility that allows you to do useful tasks without displaying any user interface.   
+Unfortunately, NirCMD is NOT installed by default on windows systems.   
+Thats why this method exists. all this method do, is download NirCMD on the remote PC using powershell.   
+Nircmd is required for the following methods:   
+1. beep   
+2. sendScreenshot   
+3. set_volume   
+4. textToSpeech   
+
+## beep
+**Requires Nircmd**   
+The beep method takes frequency(hz) and duration(millisecond) parameters.   
+Then it plays A sound at the given frequency and duration.   
+
+## getShell
+The getShell method is the most basic method.   
+It takes A shell to open as and administration privileges. (default "cmd.exe",True)   
+This is your everyday remote shell on another PC.   
+You can also choose powershell instead of cmd   
+
+## set_by_config_file
+This method is to takes a file name which includes a pre-made list of computers infomation.   
+This text file is the same as the one used by `openurl` to get a list of   
+pre-made urls except, this is for computers.   
+**Example:**
+```python
+config:
+    IP USERNAME PASSWORD
+    10.0.0.15 user p@assword
+endconfig
+
+urls:
+    name URL
+    youtube https://www.youtube.com
+endurl
+```
+You can also include a delimiter, like `,` (comma) instead of ' ' (space)  
+
+## close_process
+The close_process method takes A process name or processID, and delay_before to wait before the program closes the process.   
+Then it uses taskkill (CMD command) to close it.   
+
+
+## close_chrome
+This method closes every chrome tab on the remote machine.   
+It takes 2 parameters: runAsAdmin, and delay_before. (Default True)       
+
+
+## textToSpeech
+**Requires Nircmd**   
+The textToSpeech method takes A string to speak, and MaleVoice as a boolean. (default True)   
+Then it uses NirCMD to speak the text on the remote PC.   
+
+## set_volume
+**Requires Nircmd**   
+The set_volume method takes a number from 0 to 100 as the percentage And delay_before.   
+Then it opens NirCMD in the remote pc and uses "setsysvolume" to set the computer's volume.   
+If the volume is set to zero, it will mute the remote pc.
+If the volume is set to 101, it will un-mute the remote pc (A pc can be muted, but the volume is high.)
+
+
+## send_screenshot
+**Requires Nircmd**   
+The sendScreenshot takes email address and delay_before.    
+It uses NirCMD to take A screenshot, save it to C:\epsexecScreenshot.png   
+Then, it uses powershell SMTPClient.send() to send an email to the given Email Address   
+
+# openurl 
+This method is the most complicated method.   
+It can potentially take multiple parameters.   
+RECOMMENDED: Go to `chrome://extensions` on the remote machine. then go to your AdBlocker's settings.   
+Click **"Allow in incognito"**. This will allow your AdBlocker on incognito.   
+So YouTube songs will not load ads, making for better experience.   
+
+I will now explain every parameter:   
+**`URL`** --- This is the URL to be opened in the remote machine. If `fromFile` parameter is used, it must be: `'*://*/*'`, its default   
+
+**`fromFile`** --- This parameter is used to take A text file and get every URL and its shotcut name.   
+**[See more](https://github.com/orishamir/Epsexec/blob/master/fromFile.md)**   
+
+**`delimiter`** --- This is only if you also specified `fromFile` - How to seperate each name,url
+
+**`tabs`** --- This parameter is responsible for the amount of tabs to open on the remote machine. (Default=1)   
+
+**`delayBeforeOpening`** --- This parameter decides how much time in millisecond the program should pause before starting the operation. (Default=100)   
+
+**`delayBetweenTabs`** --- This parameter decides how much time in millisecond the program should pause BETWEEN every time it opens A new tab.
+
+**`new_window`** --- This parameter decides whether or not to open the tab(s) in new window each time. (Default=False)    
+
+**`incognito`** --- This parameter decides if the tab(s) would be opened in Incognito mode. (Default=False)   
+
+**`invisible`** --- This parameter decides if the tab(s) would be opened invisibly, and not interactive, so the user would not notice its opened, unless the window plays sound (Default=False).    
+
+
+Available class methods:   
+```python
+Help on class PsPc in module epsexec:
+
+class PsPc(builtins.object)
+ |  PsPc(**kwargs)
+ |
+ |  Methods defined here:
+ |
+ |  __getitem__(self, item)
+ |
+ |  __init__(self, **kwargs)
+ |      Initialize self.  See help(type(self)) for accurate signature.
+ |
+ |  __repr__(self)
+ |      Return repr(self).
+ |
+ |  __setitem__(self, key, value)
+ |
+ |  beep(self, frequency, duration_ms, delay_before=0)
+ |
+ |  close_chrome(self, delay_before=0)
+ |
+ |  close_process(self, proc_name, delay_before=0)
+ |      proc_name --- The process to close (could be either a name, or an ID).
+ |      delay_before --- The amount (in milliseconds) to pause before closing the process.
+ |
+ |  download_nir(self)
+ |
+ |  enable_remote_desktop(self)
+ |
+ |  firewallChange(self, state='smb', delay_before=0)
+ |      state --- Controls the operation to perform.
+ |          off/on - Turn off/on the firewall.
+ |          smb - Add a rule to allow smb connections (recommended).
+ |          rdp - Add a rule to allow remote desktop connections.
+ |
+ |      delay_before --- The amount (in milliseconds) to pause before performing the operation.
+ |
+ |  getShell(self, shell='cmd.exe', run_as_admin=True)
+ |      shell --- program to open (default "cmd.exe")
+ |      run_as_admin --- Should the shell be ran with administrative privileges (default True)
+ |
+ |  openurl(self, url='*://*/*', fromFile='fileName.txt', delimiter=' ', tabs=1, new_window=False, delay_before=0, delay_between=10, incognito=False, invisible=False)
+ |      URL --- This is the URL to be opened in the remote machine. If `fromFile` parameter is used, it must be: `'*://*/*'`, its default
+ |
+ |      fromFile --- This parameter is used to take A text file and get every URL and its shotcut name.
+ |      See more: https://github.com/orishamir/Epsexec/blob/master/fromFile.md
+ |
+ |      delimiter --- This is only if you also specified `fromFile` - How to seperate each name,url
+ |
+ |      tabs --- This parameter is responsible for the amount of tabs to open on the remote machine. (Default=1)
+ |
+ |
+ |
+ |
+ |      incognito --- This parameter decides if the tab(s) would be opened in Incognito mode. (Default=False)
+ |
+ |      invisible --- This parameter decides if the tab(s) would be opened invisibly, and not interactive, so the user would not notice its opened, unless the window plays sound (Default=False).
+ |
+ |  run_command(self, program, arguments, delay_before=0, run_as_admin=True, invisible=False)
+ |
+ |  send_screenshot(self, email_recipient_addr, delay_before=0)
+ |
+ |  set_by_config_file(self, file_name, delimiter=' ', extern=False)
+ |
+ |  set_volume(self, percent, delay_before=0)
+ |
+ |  startRemoteDesktop(self)
+ |
+ |  textToSpeech(self, text, male_voice=True, delay_before=0)
+ |
+ |  ----------------------------------------------------------------------
+ |  Static methods defined here:
+ |
+ |  download_psexec()
+ |
+ |  ----------------------------------------------------------------------
+ |  Data descriptors defined here:
+ |
+ |  __dict__
+ |      dictionary for instance variables (if defined)
+ |
+ |  __weakref__
+ |      list of weak references to the object (if defined)
+
+```
+
+### Credits
+Epsexec was created by Ori Shamir.   
+If you find any bugs, PLEASE report to ***`EpsexecNoReply@gmail.com`***
+
+
+### Changelog:
+**0.4.9** - Fixed openurl delayBetweenTabs not working properly.   
+
+**0.5.1:**   
+* Added this changelog.   
+* Added static method `download_psexec`. This is to download PsExec on your machine.
+* openurl method now automatically gets the installation folder of google chrome.      
+* PEP 8:
+    * Changed `downloadNirCMD` method name to `download_nir`.   
+    * Changed `sleepBefore` parameter name to `delay_before`.   
+    * Changed `durationMs` parameter name to `duration_ms` in `beep` method.      
+
+
+**0.5.3:**   
+* Now, openurl saves the installation folder to `globals` dictionary, so you wont do the search process twice.   
+
+**0.5.5:**
+* `get_installation_folder` is A nested function inside `openurl`.   
+ It gets called if `globals()` dictionary does NOT contain Chrome installation location.    
+
+**0.5.6:**   
+* PEP 8:
+    * Changed `sendScreenshot` method name to `send_screenshot`.   
+    * Changed `newWindow` parameter name to `new_window`.
+
+**0.5.7:**   
+* Added `enable_remote_desktop` method.
+* Added value `"rdp"` to the `firewallChange` method to allow rdp connections.    
+* Change value `"rule"` to `"smb"` in the `firewallChange` method to allow smb connections.   
+* PEP 8:
+    * When importing, use `from` **`e`**`psexec import PsPc`   
+    instead of   
+    `from Epsexec import PsPc`.    
+    * Changed `maleVoice` parameter name to `male_voice` in the method `textToSpeech`.
+    * Changed `URL` parameter name to `url` in the method `openurl`.
+
+
+**0.5.9:**
+* **`Enhanced-PsExec Now supports 32-bit version of python`**
+* Removed `runAsAdmin` parameter from the `close_chrome` method
+* PEP 8:   
+    * Changed `isAdmin` parameter name to `run_as_admin` in the method `getShell`  
+
+**0.6.0:**
+* **Added method `set_by_config_file`.**   
+  This method takes at least one parameter:   
+  1. `file_name` - string, The name of the file.
+  3. `delimiter` - character, what to seperate ip,username,password with.   
+  3. `extern`    - boolean.   
+  The `extern` parameter needs to be included with a `True` value if   
+    You want to change pc information AFTER initializing the object.   
+    To Initialize a object with information by a file, do this:   
+    `pc = PsPc(file="file_name.txt")`
+* Added a `delimiter` parameter to the openurl function.
+
+**0.6.1:**
+* PEP 8:
+    * Changed `closeProcess` method name to `close_process`.
+    * Changed `procNameOrID` parameter name to `proc_name` in the `close_process` method.
+
+**0.6.2:**
+* PEP 8:
+    * Changed `closeChrome` method name to `close_chrome`
+
+**0.6.3:**
+* Added `run_command` method
+* PEP 8:
+    * Chagned `setVolume` method name to `set_volume`
+
+## **0.6.4:**
+* Changed class name from `psPc` to `PsPc`
+* Changed `procNameOrID` parameter name to `proc_name` in the `close_process` method.
+* Code changes to make the `set_by_config_file` method better.
+* Added `__repr__`, `__setitem__` and __getitem__`. How to use:
+    ```python
+    from epsexec import PsPc 
+    pc = PsPc(i="IP", u="username", p="pass")
+    print(pc[0])
+    # Output:
+    # IP
+    pc[0] = "127.0.0.1"
+    # Sets the ip to 127.0.0.1
+    ```
+
+### TODO:
+1) Add a method to import computers from a config file (like in `urls.txt`)   
+1.1) DONE!
+2) Give me suggestions! at `EpsexecNoReply@gmail.com`
+
+
+
+
+%package -n python3-Enhanced-PsExec
+Summary:	Perform miscellaneous operations on A remote computer with Enhanced PsExec
+Provides:	python-Enhanced-PsExec
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-Enhanced-PsExec
+#### !!!!!!!!!! Use "help(PsPc)" This will show you the available methods. (This usage form will contain it, but it is yet to be completed.) !!!!!!!!!!
+
+### About
+epsexec (Enhanced psexec) uses [Microsoft's Sysinternals PsExec](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec) utility that uses SMB to execute programs on remote systems.
+PsExec is a light-weight telnet replacement.    
+If you find any bugs, PLEASE report to ***`EpsexecNoReply@gmail.com`***   
+
+### Installation
+Run the following to install:   
+```
+pip install Enhanced-PsExec
+```
+
+# Requirements
+**Attacker Machine:**   
+1) You MUST have [psexec install](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec)ed   
+   **If you have A 32-bit installation, install psexec to `C:\windows\sysWOW64`.**   
+   Else, to `C:\windows\system32`   
+   **Recommended:**   
+   *The `PsPc` class has a static method `download_psexec` that can automate the process for you.*   
+   *Run: `PsPc.download_psexec()`*    
+2) You MUST run python as administrator (Ctrl+Esc, type "python", Ctrl+Shift+Enter,Alt-Y).
+
+**The Remote PC:**   
+The remote pc (The pc that you are attacking) have very few requirements;
+1) SMBv2 needs to be up and running on the Windows port. Run this CMD script on the remote computer:
+`powershell.exe Set-SmbServerConfiguration -EnableSMB2Protocol $true`
+2) The ADMIN$ share to be enabled with read/write access of the user configured.   
+   Unless the machine already has an administrator user with password, I recommend making Another user that is administrator.   
+   CMD:   
+`net user /add usernameToHack passToBeUsed`   
+To enable administrator:   
+`net localgroup administrators usernameToHack /add`    
+
+3) You'll need to add A registry key.   
+This is because UAC is set up to deny connections like this, so you will get an `ACCESS_IS_DENIED` error when attempting to connect.   
+Fix: run CMD as administrator and run:   
+`reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\system /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f`   
+
+4) RECOMMENDED: Disable firewall on the remote machine.   
+This will allow for a faster experience while connecting.   
+There is also A method to do this, so you dont need to go to the remote PC NOW.   
+you can do it remotely using: `pc.firewallChange(state="rule")`   
+Or, run on this on the remote machine in administrator CMD:   
+`netsh advfirewall firewall set rule name="File and Printer Sharing (SMB-In)" dir=in new enable=Yes`   
+Or, you can just disable the firewall entirely administrator CMD:   
+`netsh advfirewall set allprofiles state off`
+
+5) Restart the system.   
+
+## Import
+To import the package, use `from epsexec import PsPc`.   
+
+# Usage
+1) Create a PsPc class instance.   
+```python
+pc1 = PsPc(ip="IPv4", username="username", password="password")   
+```
+Or, if you want to import from a file:
+```python
+pc1 = PsPc(file="name_of_file.txt")
+```
+General settings:   
+
+**`delay_before`** --- This pauses the operation {delay_before} millisecond before starting the operation.  (Default 100)   
+**`run_as_admin`**  --- If true, it will run the operation in administrative privileges. (default True)   
+
+## firewallChange
+This is probably the most important method. why?   
+Well, because firewall makes the psexec process extremely slow (It takes about 12 seconds instead of 1).   
+So, it becomes very frustrating.   
+Modes:
+1. "on" to enable firewall on the remote machine.
+2. "off" to disable firewall on the remote machine.
+3. "smb" to add a SMB-only rule. This will allow connections from port 445 (smb)
+4. "rdp" to add a remote desktop rule to make connections from remote desktop easier.  
+
+## download_nir
+[NirCMD](https://www.nirsoft.net/utils/nircmd.html) is A windows command-line utility that allows you to do useful tasks without displaying any user interface.   
+Unfortunately, NirCMD is NOT installed by default on windows systems.   
+Thats why this method exists. all this method do, is download NirCMD on the remote PC using powershell.   
+Nircmd is required for the following methods:   
+1. beep   
+2. sendScreenshot   
+3. set_volume   
+4. textToSpeech   
+
+## beep
+**Requires Nircmd**   
+The beep method takes frequency(hz) and duration(millisecond) parameters.   
+Then it plays A sound at the given frequency and duration.   
+
+## getShell
+The getShell method is the most basic method.   
+It takes A shell to open as and administration privileges. (default "cmd.exe",True)   
+This is your everyday remote shell on another PC.   
+You can also choose powershell instead of cmd   
+
+## set_by_config_file
+This method is to takes a file name which includes a pre-made list of computers infomation.   
+This text file is the same as the one used by `openurl` to get a list of   
+pre-made urls except, this is for computers.   
+**Example:**
+```python
+config:
+    IP USERNAME PASSWORD
+    10.0.0.15 user p@assword
+endconfig
+
+urls:
+    name URL
+    youtube https://www.youtube.com
+endurl
+```
+You can also include a delimiter, like `,` (comma) instead of ' ' (space)  
+
+## close_process
+The close_process method takes A process name or processID, and delay_before to wait before the program closes the process.   
+Then it uses taskkill (CMD command) to close it.   
+
+
+## close_chrome
+This method closes every chrome tab on the remote machine.   
+It takes 2 parameters: runAsAdmin, and delay_before. (Default True)       
+
+
+## textToSpeech
+**Requires Nircmd**   
+The textToSpeech method takes A string to speak, and MaleVoice as a boolean. (default True)   
+Then it uses NirCMD to speak the text on the remote PC.   
+
+## set_volume
+**Requires Nircmd**   
+The set_volume method takes a number from 0 to 100 as the percentage And delay_before.   
+Then it opens NirCMD in the remote pc and uses "setsysvolume" to set the computer's volume.   
+If the volume is set to zero, it will mute the remote pc.
+If the volume is set to 101, it will un-mute the remote pc (A pc can be muted, but the volume is high.)
+
+
+## send_screenshot
+**Requires Nircmd**   
+The sendScreenshot takes email address and delay_before.    
+It uses NirCMD to take A screenshot, save it to C:\epsexecScreenshot.png   
+Then, it uses powershell SMTPClient.send() to send an email to the given Email Address   
+
+# openurl 
+This method is the most complicated method.   
+It can potentially take multiple parameters.   
+RECOMMENDED: Go to `chrome://extensions` on the remote machine. then go to your AdBlocker's settings.   
+Click **"Allow in incognito"**. This will allow your AdBlocker on incognito.   
+So YouTube songs will not load ads, making for better experience.   
+
+I will now explain every parameter:   
+**`URL`** --- This is the URL to be opened in the remote machine. If `fromFile` parameter is used, it must be: `'*://*/*'`, its default   
+
+**`fromFile`** --- This parameter is used to take A text file and get every URL and its shotcut name.   
+**[See more](https://github.com/orishamir/Epsexec/blob/master/fromFile.md)**   
+
+**`delimiter`** --- This is only if you also specified `fromFile` - How to seperate each name,url
+
+**`tabs`** --- This parameter is responsible for the amount of tabs to open on the remote machine. (Default=1)   
+
+**`delayBeforeOpening`** --- This parameter decides how much time in millisecond the program should pause before starting the operation. (Default=100)   
+
+**`delayBetweenTabs`** --- This parameter decides how much time in millisecond the program should pause BETWEEN every time it opens A new tab.
+
+**`new_window`** --- This parameter decides whether or not to open the tab(s) in new window each time. (Default=False)    
+
+**`incognito`** --- This parameter decides if the tab(s) would be opened in Incognito mode. (Default=False)   
+
+**`invisible`** --- This parameter decides if the tab(s) would be opened invisibly, and not interactive, so the user would not notice its opened, unless the window plays sound (Default=False).    
+
+
+Available class methods:   
+```python
+Help on class PsPc in module epsexec:
+
+class PsPc(builtins.object)
+ |  PsPc(**kwargs)
+ |
+ |  Methods defined here:
+ |
+ |  __getitem__(self, item)
+ |
+ |  __init__(self, **kwargs)
+ |      Initialize self.  See help(type(self)) for accurate signature.
+ |
+ |  __repr__(self)
+ |      Return repr(self).
+ |
+ |  __setitem__(self, key, value)
+ |
+ |  beep(self, frequency, duration_ms, delay_before=0)
+ |
+ |  close_chrome(self, delay_before=0)
+ |
+ |  close_process(self, proc_name, delay_before=0)
+ |      proc_name --- The process to close (could be either a name, or an ID).
+ |      delay_before --- The amount (in milliseconds) to pause before closing the process.
+ |
+ |  download_nir(self)
+ |
+ |  enable_remote_desktop(self)
+ |
+ |  firewallChange(self, state='smb', delay_before=0)
+ |      state --- Controls the operation to perform.
+ |          off/on - Turn off/on the firewall.
+ |          smb - Add a rule to allow smb connections (recommended).
+ |          rdp - Add a rule to allow remote desktop connections.
+ |
+ |      delay_before --- The amount (in milliseconds) to pause before performing the operation.
+ |
+ |  getShell(self, shell='cmd.exe', run_as_admin=True)
+ |      shell --- program to open (default "cmd.exe")
+ |      run_as_admin --- Should the shell be ran with administrative privileges (default True)
+ |
+ |  openurl(self, url='*://*/*', fromFile='fileName.txt', delimiter=' ', tabs=1, new_window=False, delay_before=0, delay_between=10, incognito=False, invisible=False)
+ |      URL --- This is the URL to be opened in the remote machine. If `fromFile` parameter is used, it must be: `'*://*/*'`, its default
+ |
+ |      fromFile --- This parameter is used to take A text file and get every URL and its shotcut name.
+ |      See more: https://github.com/orishamir/Epsexec/blob/master/fromFile.md
+ |
+ |      delimiter --- This is only if you also specified `fromFile` - How to seperate each name,url
+ |
+ |      tabs --- This parameter is responsible for the amount of tabs to open on the remote machine. (Default=1)
+ |
+ |
+ |
+ |
+ |      incognito --- This parameter decides if the tab(s) would be opened in Incognito mode. (Default=False)
+ |
+ |      invisible --- This parameter decides if the tab(s) would be opened invisibly, and not interactive, so the user would not notice its opened, unless the window plays sound (Default=False).
+ |
+ |  run_command(self, program, arguments, delay_before=0, run_as_admin=True, invisible=False)
+ |
+ |  send_screenshot(self, email_recipient_addr, delay_before=0)
+ |
+ |  set_by_config_file(self, file_name, delimiter=' ', extern=False)
+ |
+ |  set_volume(self, percent, delay_before=0)
+ |
+ |  startRemoteDesktop(self)
+ |
+ |  textToSpeech(self, text, male_voice=True, delay_before=0)
+ |
+ |  ----------------------------------------------------------------------
+ |  Static methods defined here:
+ |
+ |  download_psexec()
+ |
+ |  ----------------------------------------------------------------------
+ |  Data descriptors defined here:
+ |
+ |  __dict__
+ |      dictionary for instance variables (if defined)
+ |
+ |  __weakref__
+ |      list of weak references to the object (if defined)
+
+```
+
+### Credits
+Epsexec was created by Ori Shamir.   
+If you find any bugs, PLEASE report to ***`EpsexecNoReply@gmail.com`***
+
+
+### Changelog:
+**0.4.9** - Fixed openurl delayBetweenTabs not working properly.   
+
+**0.5.1:**   
+* Added this changelog.   
+* Added static method `download_psexec`. This is to download PsExec on your machine.
+* openurl method now automatically gets the installation folder of google chrome.      
+* PEP 8:
+    * Changed `downloadNirCMD` method name to `download_nir`.   
+    * Changed `sleepBefore` parameter name to `delay_before`.   
+    * Changed `durationMs` parameter name to `duration_ms` in `beep` method.      
+
+
+**0.5.3:**   
+* Now, openurl saves the installation folder to `globals` dictionary, so you wont do the search process twice.   
+
+**0.5.5:**
+* `get_installation_folder` is A nested function inside `openurl`.   
+ It gets called if `globals()` dictionary does NOT contain Chrome installation location.    
+
+**0.5.6:**   
+* PEP 8:
+    * Changed `sendScreenshot` method name to `send_screenshot`.   
+    * Changed `newWindow` parameter name to `new_window`.
+
+**0.5.7:**   
+* Added `enable_remote_desktop` method.
+* Added value `"rdp"` to the `firewallChange` method to allow rdp connections.    
+* Change value `"rule"` to `"smb"` in the `firewallChange` method to allow smb connections.   
+* PEP 8:
+    * When importing, use `from` **`e`**`psexec import PsPc`   
+    instead of   
+    `from Epsexec import PsPc`.    
+    * Changed `maleVoice` parameter name to `male_voice` in the method `textToSpeech`.
+    * Changed `URL` parameter name to `url` in the method `openurl`.
+
+
+**0.5.9:**
+* **`Enhanced-PsExec Now supports 32-bit version of python`**
+* Removed `runAsAdmin` parameter from the `close_chrome` method
+* PEP 8:   
+    * Changed `isAdmin` parameter name to `run_as_admin` in the method `getShell`  
+
+**0.6.0:**
+* **Added method `set_by_config_file`.**   
+  This method takes at least one parameter:   
+  1. `file_name` - string, The name of the file.
+  3. `delimiter` - character, what to seperate ip,username,password with.   
+  3. `extern`    - boolean.   
+  The `extern` parameter needs to be included with a `True` value if   
+    You want to change pc information AFTER initializing the object.   
+    To Initialize a object with information by a file, do this:   
+    `pc = PsPc(file="file_name.txt")`
+* Added a `delimiter` parameter to the openurl function.
+
+**0.6.1:**
+* PEP 8:
+    * Changed `closeProcess` method name to `close_process`.
+    * Changed `procNameOrID` parameter name to `proc_name` in the `close_process` method.
+
+**0.6.2:**
+* PEP 8:
+    * Changed `closeChrome` method name to `close_chrome`
+
+**0.6.3:**
+* Added `run_command` method
+* PEP 8:
+    * Chagned `setVolume` method name to `set_volume`
+
+## **0.6.4:**
+* Changed class name from `psPc` to `PsPc`
+* Changed `procNameOrID` parameter name to `proc_name` in the `close_process` method.
+* Code changes to make the `set_by_config_file` method better.
+* Added `__repr__`, `__setitem__` and __getitem__`. How to use:
+    ```python
+    from epsexec import PsPc 
+    pc = PsPc(i="IP", u="username", p="pass")
+    print(pc[0])
+    # Output:
+    # IP
+    pc[0] = "127.0.0.1"
+    # Sets the ip to 127.0.0.1
+    ```
+
+### TODO:
+1) Add a method to import computers from a config file (like in `urls.txt`)   
+1.1) DONE!
+2) Give me suggestions! at `EpsexecNoReply@gmail.com`
+
+
+
+
+%package help
+Summary:	Development documents and examples for Enhanced-PsExec
+Provides:	python3-Enhanced-PsExec-doc
+%description help
+#### !!!!!!!!!! Use "help(PsPc)" This will show you the available methods. (This usage form will contain it, but it is yet to be completed.) !!!!!!!!!!
+
+### About
+epsexec (Enhanced psexec) uses [Microsoft's Sysinternals PsExec](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec) utility that uses SMB to execute programs on remote systems.
+PsExec is a light-weight telnet replacement.    
+If you find any bugs, PLEASE report to ***`EpsexecNoReply@gmail.com`***   
+
+### Installation
+Run the following to install:   
+```
+pip install Enhanced-PsExec
+```
+
+# Requirements
+**Attacker Machine:**   
+1) You MUST have [psexec install](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec)ed   
+   **If you have A 32-bit installation, install psexec to `C:\windows\sysWOW64`.**   
+   Else, to `C:\windows\system32`   
+   **Recommended:**   
+   *The `PsPc` class has a static method `download_psexec` that can automate the process for you.*   
+   *Run: `PsPc.download_psexec()`*    
+2) You MUST run python as administrator (Ctrl+Esc, type "python", Ctrl+Shift+Enter,Alt-Y).
+
+**The Remote PC:**   
+The remote pc (The pc that you are attacking) have very few requirements;
+1) SMBv2 needs to be up and running on the Windows port. Run this CMD script on the remote computer:
+`powershell.exe Set-SmbServerConfiguration -EnableSMB2Protocol $true`
+2) The ADMIN$ share to be enabled with read/write access of the user configured.   
+   Unless the machine already has an administrator user with password, I recommend making Another user that is administrator.   
+   CMD:   
+`net user /add usernameToHack passToBeUsed`   
+To enable administrator:   
+`net localgroup administrators usernameToHack /add`    
+
+3) You'll need to add A registry key.   
+This is because UAC is set up to deny connections like this, so you will get an `ACCESS_IS_DENIED` error when attempting to connect.   
+Fix: run CMD as administrator and run:   
+`reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\system /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f`   
+
+4) RECOMMENDED: Disable firewall on the remote machine.   
+This will allow for a faster experience while connecting.   
+There is also A method to do this, so you dont need to go to the remote PC NOW.   
+you can do it remotely using: `pc.firewallChange(state="rule")`   
+Or, run on this on the remote machine in administrator CMD:   
+`netsh advfirewall firewall set rule name="File and Printer Sharing (SMB-In)" dir=in new enable=Yes`   
+Or, you can just disable the firewall entirely administrator CMD:   
+`netsh advfirewall set allprofiles state off`
+
+5) Restart the system.   
+
+## Import
+To import the package, use `from epsexec import PsPc`.   
+
+# Usage
+1) Create a PsPc class instance.   
+```python
+pc1 = PsPc(ip="IPv4", username="username", password="password")   
+```
+Or, if you want to import from a file:
+```python
+pc1 = PsPc(file="name_of_file.txt")
+```
+General settings:   
+
+**`delay_before`** --- This pauses the operation {delay_before} millisecond before starting the operation.  (Default 100)   
+**`run_as_admin`**  --- If true, it will run the operation in administrative privileges. (default True)   
+
+## firewallChange
+This is probably the most important method. why?   
+Well, because firewall makes the psexec process extremely slow (It takes about 12 seconds instead of 1).   
+So, it becomes very frustrating.   
+Modes:
+1. "on" to enable firewall on the remote machine.
+2. "off" to disable firewall on the remote machine.
+3. "smb" to add a SMB-only rule. This will allow connections from port 445 (smb)
+4. "rdp" to add a remote desktop rule to make connections from remote desktop easier.  
+
+## download_nir
+[NirCMD](https://www.nirsoft.net/utils/nircmd.html) is A windows command-line utility that allows you to do useful tasks without displaying any user interface.   
+Unfortunately, NirCMD is NOT installed by default on windows systems.   
+Thats why this method exists. all this method do, is download NirCMD on the remote PC using powershell.   
+Nircmd is required for the following methods:   
+1. beep   
+2. sendScreenshot   
+3. set_volume   
+4. textToSpeech   
+
+## beep
+**Requires Nircmd**   
+The beep method takes frequency(hz) and duration(millisecond) parameters.   
+Then it plays A sound at the given frequency and duration.   
+
+## getShell
+The getShell method is the most basic method.   
+It takes A shell to open as and administration privileges. (default "cmd.exe",True)   
+This is your everyday remote shell on another PC.   
+You can also choose powershell instead of cmd   
+
+## set_by_config_file
+This method is to takes a file name which includes a pre-made list of computers infomation.   
+This text file is the same as the one used by `openurl` to get a list of   
+pre-made urls except, this is for computers.   
+**Example:**
+```python
+config:
+    IP USERNAME PASSWORD
+    10.0.0.15 user p@assword
+endconfig
+
+urls:
+    name URL
+    youtube https://www.youtube.com
+endurl
+```
+You can also include a delimiter, like `,` (comma) instead of ' ' (space)  
+
+## close_process
+The close_process method takes A process name or processID, and delay_before to wait before the program closes the process.   
+Then it uses taskkill (CMD command) to close it.   
+
+
+## close_chrome
+This method closes every chrome tab on the remote machine.   
+It takes 2 parameters: runAsAdmin, and delay_before. (Default True)       
+
+
+## textToSpeech
+**Requires Nircmd**   
+The textToSpeech method takes A string to speak, and MaleVoice as a boolean. (default True)   
+Then it uses NirCMD to speak the text on the remote PC.   
+
+## set_volume
+**Requires Nircmd**   
+The set_volume method takes a number from 0 to 100 as the percentage And delay_before.   
+Then it opens NirCMD in the remote pc and uses "setsysvolume" to set the computer's volume.   
+If the volume is set to zero, it will mute the remote pc.
+If the volume is set to 101, it will un-mute the remote pc (A pc can be muted, but the volume is high.)
+
+
+## send_screenshot
+**Requires Nircmd**   
+The sendScreenshot takes email address and delay_before.    
+It uses NirCMD to take A screenshot, save it to C:\epsexecScreenshot.png   
+Then, it uses powershell SMTPClient.send() to send an email to the given Email Address   
+
+# openurl 
+This method is the most complicated method.   
+It can potentially take multiple parameters.   
+RECOMMENDED: Go to `chrome://extensions` on the remote machine. then go to your AdBlocker's settings.   
+Click **"Allow in incognito"**. This will allow your AdBlocker on incognito.   
+So YouTube songs will not load ads, making for better experience.   
+
+I will now explain every parameter:   
+**`URL`** --- This is the URL to be opened in the remote machine. If `fromFile` parameter is used, it must be: `'*://*/*'`, its default   
+
+**`fromFile`** --- This parameter is used to take A text file and get every URL and its shotcut name.   
+**[See more](https://github.com/orishamir/Epsexec/blob/master/fromFile.md)**   
+
+**`delimiter`** --- This is only if you also specified `fromFile` - How to seperate each name,url
+
+**`tabs`** --- This parameter is responsible for the amount of tabs to open on the remote machine. (Default=1)   
+
+**`delayBeforeOpening`** --- This parameter decides how much time in millisecond the program should pause before starting the operation. (Default=100)   
+
+**`delayBetweenTabs`** --- This parameter decides how much time in millisecond the program should pause BETWEEN every time it opens A new tab.
+
+**`new_window`** --- This parameter decides whether or not to open the tab(s) in new window each time. (Default=False)    
+
+**`incognito`** --- This parameter decides if the tab(s) would be opened in Incognito mode. (Default=False)   
+
+**`invisible`** --- This parameter decides if the tab(s) would be opened invisibly, and not interactive, so the user would not notice its opened, unless the window plays sound (Default=False).    
+
+
+Available class methods:   
+```python
+Help on class PsPc in module epsexec:
+
+class PsPc(builtins.object)
+ |  PsPc(**kwargs)
+ |
+ |  Methods defined here:
+ |
+ |  __getitem__(self, item)
+ |
+ |  __init__(self, **kwargs)
+ |      Initialize self.  See help(type(self)) for accurate signature.
+ |
+ |  __repr__(self)
+ |      Return repr(self).
+ |
+ |  __setitem__(self, key, value)
+ |
+ |  beep(self, frequency, duration_ms, delay_before=0)
+ |
+ |  close_chrome(self, delay_before=0)
+ |
+ |  close_process(self, proc_name, delay_before=0)
+ |      proc_name --- The process to close (could be either a name, or an ID).
+ |      delay_before --- The amount (in milliseconds) to pause before closing the process.
+ |
+ |  download_nir(self)
+ |
+ |  enable_remote_desktop(self)
+ |
+ |  firewallChange(self, state='smb', delay_before=0)
+ |      state --- Controls the operation to perform.
+ |          off/on - Turn off/on the firewall.
+ |          smb - Add a rule to allow smb connections (recommended).
+ |          rdp - Add a rule to allow remote desktop connections.
+ |
+ |      delay_before --- The amount (in milliseconds) to pause before performing the operation.
+ |
+ |  getShell(self, shell='cmd.exe', run_as_admin=True)
+ |      shell --- program to open (default "cmd.exe")
+ |      run_as_admin --- Should the shell be ran with administrative privileges (default True)
+ |
+ |  openurl(self, url='*://*/*', fromFile='fileName.txt', delimiter=' ', tabs=1, new_window=False, delay_before=0, delay_between=10, incognito=False, invisible=False)
+ |      URL --- This is the URL to be opened in the remote machine. If `fromFile` parameter is used, it must be: `'*://*/*'`, its default
+ |
+ |      fromFile --- This parameter is used to take A text file and get every URL and its shotcut name.
+ |      See more: https://github.com/orishamir/Epsexec/blob/master/fromFile.md
+ |
+ |      delimiter --- This is only if you also specified `fromFile` - How to seperate each name,url
+ |
+ |      tabs --- This parameter is responsible for the amount of tabs to open on the remote machine. (Default=1)
+ |
+ |
+ |
+ |
+ |      incognito --- This parameter decides if the tab(s) would be opened in Incognito mode. (Default=False)
+ |
+ |      invisible --- This parameter decides if the tab(s) would be opened invisibly, and not interactive, so the user would not notice its opened, unless the window plays sound (Default=False).
+ |
+ |  run_command(self, program, arguments, delay_before=0, run_as_admin=True, invisible=False)
+ |
+ |  send_screenshot(self, email_recipient_addr, delay_before=0)
+ |
+ |  set_by_config_file(self, file_name, delimiter=' ', extern=False)
+ |
+ |  set_volume(self, percent, delay_before=0)
+ |
+ |  startRemoteDesktop(self)
+ |
+ |  textToSpeech(self, text, male_voice=True, delay_before=0)
+ |
+ |  ----------------------------------------------------------------------
+ |  Static methods defined here:
+ |
+ |  download_psexec()
+ |
+ |  ----------------------------------------------------------------------
+ |  Data descriptors defined here:
+ |
+ |  __dict__
+ |      dictionary for instance variables (if defined)
+ |
+ |  __weakref__
+ |      list of weak references to the object (if defined)
+
+```
+
+### Credits
+Epsexec was created by Ori Shamir.   
+If you find any bugs, PLEASE report to ***`EpsexecNoReply@gmail.com`***
+
+
+### Changelog:
+**0.4.9** - Fixed openurl delayBetweenTabs not working properly.   
+
+**0.5.1:**   
+* Added this changelog.   
+* Added static method `download_psexec`. This is to download PsExec on your machine.
+* openurl method now automatically gets the installation folder of google chrome.      
+* PEP 8:
+    * Changed `downloadNirCMD` method name to `download_nir`.   
+    * Changed `sleepBefore` parameter name to `delay_before`.   
+    * Changed `durationMs` parameter name to `duration_ms` in `beep` method.      
+
+
+**0.5.3:**   
+* Now, openurl saves the installation folder to `globals` dictionary, so you wont do the search process twice.   
+
+**0.5.5:**
+* `get_installation_folder` is A nested function inside `openurl`.   
+ It gets called if `globals()` dictionary does NOT contain Chrome installation location.    
+
+**0.5.6:**   
+* PEP 8:
+    * Changed `sendScreenshot` method name to `send_screenshot`.   
+    * Changed `newWindow` parameter name to `new_window`.
+
+**0.5.7:**   
+* Added `enable_remote_desktop` method.
+* Added value `"rdp"` to the `firewallChange` method to allow rdp connections.    
+* Change value `"rule"` to `"smb"` in the `firewallChange` method to allow smb connections.   
+* PEP 8:
+    * When importing, use `from` **`e`**`psexec import PsPc`   
+    instead of   
+    `from Epsexec import PsPc`.    
+    * Changed `maleVoice` parameter name to `male_voice` in the method `textToSpeech`.
+    * Changed `URL` parameter name to `url` in the method `openurl`.
+
+
+**0.5.9:**
+* **`Enhanced-PsExec Now supports 32-bit version of python`**
+* Removed `runAsAdmin` parameter from the `close_chrome` method
+* PEP 8:   
+    * Changed `isAdmin` parameter name to `run_as_admin` in the method `getShell`  
+
+**0.6.0:**
+* **Added method `set_by_config_file`.**   
+  This method takes at least one parameter:   
+  1. `file_name` - string, The name of the file.
+  3. `delimiter` - character, what to seperate ip,username,password with.   
+  3. `extern`    - boolean.   
+  The `extern` parameter needs to be included with a `True` value if   
+    You want to change pc information AFTER initializing the object.   
+    To Initialize a object with information by a file, do this:   
+    `pc = PsPc(file="file_name.txt")`
+* Added a `delimiter` parameter to the openurl function.
+
+**0.6.1:**
+* PEP 8:
+    * Changed `closeProcess` method name to `close_process`.
+    * Changed `procNameOrID` parameter name to `proc_name` in the `close_process` method.
+
+**0.6.2:**
+* PEP 8:
+    * Changed `closeChrome` method name to `close_chrome`
+
+**0.6.3:**
+* Added `run_command` method
+* PEP 8:
+    * Chagned `setVolume` method name to `set_volume`
+
+## **0.6.4:**
+* Changed class name from `psPc` to `PsPc`
+* Changed `procNameOrID` parameter name to `proc_name` in the `close_process` method.
+* Code changes to make the `set_by_config_file` method better.
+* Added `__repr__`, `__setitem__` and __getitem__`. How to use:
+    ```python
+    from epsexec import PsPc 
+    pc = PsPc(i="IP", u="username", p="pass")
+    print(pc[0])
+    # Output:
+    # IP
+    pc[0] = "127.0.0.1"
+    # Sets the ip to 127.0.0.1
+    ```
+
+### TODO:
+1) Add a method to import computers from a config file (like in `urls.txt`)   
+1.1) DONE!
+2) Give me suggestions! at `EpsexecNoReply@gmail.com`
+
+
+
+
+%prep
+%autosetup -n Enhanced-PsExec-0.6.8
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-Enhanced-PsExec -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Mon May 29 2023 Python_Bot <Python_Bot@openeuler.org> - 0.6.8-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..c7b7114
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+2ed3bdb8da37dcedfedb27456d3ec940  Enhanced%20PsExec-0.6.8.tar.gz