AsyncRemoteShell

Description

This package implement 4 tools for asynchronous remote commands :

• ReverseShellClient
• ReverseShellServer
• ShellClient
• ShellServer

Requirements

This package require :

• python3
• python3 Standard Library

Installation

pip install AsyncRemoteShell

Usages

Commands

ReverseShell

ReverseShellClient
ReverseShellClient --interface=127.0.0.1 --port=45678
ReverseShellServer
ReverseShellServer -i=localhost -p=45678

Shell

ShellClient
ShellClient -i=10.0.0.2 --port=56789
ShellServer
ShellServer --interface= -p=56789

Python package commands

python3 -m AsyncRemoteShell ShellServer
python3 -m AsyncRemoteShell ShellClient

python3 -m AsyncRemoteShell ShellServer -i=localhost -p=3456
python3 -m AsyncRemoteShell ShellClient --interface=localhost --port=3456

python3 -m AsyncRemoteShell.ShellServer
python3 -m AsyncRemoteShell.ShellClient

python3 -m AsyncRemoteShell.ShellServer --interface=localhost --port=3456
python3 -m AsyncRemoteShell.ShellClient -i=localhost -p=3456

python3 -m AsyncRemoteShell ReverseShellServer
python3 -m AsyncRemoteShell ReverseShellClient

python3 -m AsyncRemoteShell ReverseShellServer -i=localhost -p=3456
python3 -m AsyncRemoteShell ReverseShellClient --interface=localhost --port=3456

python3 -m AsyncRemoteShell.ReverseShellServer
python3 -m AsyncRemoteShell.ReverseShellClient

python3 -m AsyncRemoteShell.ReverseShellServer --interface=localhost --port=3456
python3 -m AsyncRemoteShell.ReverseShellClient -i=localhost -p=3456

Python executable

Same commands than python package python3 -m AsyncRemoteShell <MODULE> [OPTIONS].

python3 AsyncRemoteShell.pyz ShellServer

chmod u+x AsyncRemoteShell.pyz
./AsyncRemoteShell.pyz ShellClient -i=localhost --port=45678

Python3

ReverseShell

Client:

from AsyncRemoteShell import ReverseShellClient
import asyncore
ReverseShellClient("10.0.0.2", 45678) # host and port is required
asyncore.loop()

Server:

from AsyncRemoteShell import ReverseShellServer
import asyncore
ReverseShellServer("", 45678) # interface and port is required
asyncore.loop()

Shell

Client:

from AsyncRemoteShell import ShellClient
import asyncore
ShellClient("10.0.0.2", 45678) # host and port is required
asyncore.loop()

Server:

from AsyncRemoteShell import ShellServer
import asyncore
ShellServer("", 45678) # interface and port is required
asyncore.loop()

Why Asynchronous Shell

You can install this package on Windows and execute this script:

from time import perf_counter
from os import system
t1 = perf_counter(); system('powershell -c "Get-PSDrive" & netstat & systeminfo'); t2 = perf_counter()
print(f"Execution time : {t2 - t1} s")

Launch ShellServer with command line and launch ShellClient -i=localhost -p=45678 and write: powershell -c "Get-PSDrive" & netstat & systeminfo.

Compare execution time.

Links

• AsyncRemoteShell Github Page
• ReverseShellServer Documentation
• ReverseShellClient Documentation
• ShellServer Documentation
• ShellClient Documentation
• commons Documentation
• Download as python executable
• Pypi package

Licence

Licensed under the GPL, version 3.