Skip to content

Repository files navigation

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:

fromAsyncRemoteShellimportReverseShellClientimportasyncoreReverseShellClient("10.0.0.2", 45678) # host and port is requiredasyncore.loop()

Server:

fromAsyncRemoteShellimportReverseShellServerimportasyncoreReverseShellServer("", 45678) # interface and port is requiredasyncore.loop()

Shell

Client:

fromAsyncRemoteShellimportShellClientimportasyncoreShellClient("10.0.0.2", 45678) # host and port is requiredasyncore.loop()

Server:

fromAsyncRemoteShellimportShellServerimportasyncoreShellServer("", 45678) # interface and port is requiredasyncore.loop()

Why Asynchronous Shell

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

fromtimeimportperf_counterfromosimportsystemt1=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

Licence

Licensed under the GPL, version 3.

About

This python 3 package implement 4 tools for asynchronous remote commands.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages