CWSHELL V1.0 IS NO LONGER SUPPORTED. IT WILL SOON BE DISCONTINUED AS THERE IS A NEWER VERSION (CWShell v2.0)
CWshell v1.0
A simple, open source remote shell for everyone
CW Shell is a remote shell made for controlling a computer through out the local Network.
Installation
For Windows Users:
Go to the terminal navigate to the desired directory and type:
git clone https://github.com/Hammad-hab/CWshell.git
In the CWShell folder there are two .exe
files, the server and the client. Read the tutorial below to get started
For Mac And Linux Users
Currently the mac and Linux users have to use the open Source .py
files located in /CWShell/bin/
. So they too have to clone the repository using:
git clone https://github.com/Hammad-hab/CWshell.git
then they have to install Python from Python.org. They can use the python interpreter to run the files.
On mac open the Connecter.py
. On windows open Connecter.exe
. After that wait until it gives you the ip address on which the server has been started.
Then on the client computer open connect.app
/connect.exe
and when it asks you for the IPV4 address, enter the IPV4 address of the server.
You are now successfully connected to the server.
PS.
The server may deny connection with your computer. Following is the procedure to solve that problem.
CH: 1 Allowing Ip addresses
If the server denys connection with your computer you may recive an error. To solve this problem go to the cwshell.config.json
.
In the array named whitelist, enter the ipv4 address of your client computer. After this you will be able to connect to the machine on which the server is running.
{
"whiteList": [
...
"your_ipv4_address" <-
]
}
cwshell.config.json
CH: 2 Settings and commands
CWShell allows you to run commands on the server. By default all the commands are treated as strings. To prevent this change your execution mode so that the server program considers your commands more than just standard strings. To change you execution mode to bash type $bash.
Client
>>> echo Hello
>>> $bash
>>> echo Hello
Server
[CWSHELL] Active connections 1
127.0.0.1 says echo Hello
127.0.0.1 switched to bash mode
Hello
Note: In CWShell all commands begining with $
are considerd as modes
Other
exit
: This command breaks the connection, it is equal to typing -
CWShellv1.2 is HERE
Be the first to get the source at https://github.com/Hammad-hab/CWShell-1.2.git. Use the following command to download the source from github:
git clone https://github.com/Hammad-hab/CWShell-1.2.git