Skip to main content

Netcat-style remote command execution using Python socket.

Project description

ghostshell

A Netcat-style remote command execution tool using raw Python sockets.

Features

  • Raw socket client/server
  • CLI and importable API
  • Supports multiple requests per session

Installation

From PIP

pip install ghostshell

Manual Installation using setup.py

  • Clone this git repo
  • cd ghostshell
  • Run
pip install .

CLI Usage

For Code/module CLI:

 python -m ghostshell.cli.main serve --host 0.0.0.0 --port 9999
 python -m ghostshell.cli.main connect --host 127.0.0.1 --port 9999

For Installed CLI package:

ghostshell serve --host 0.0.0.0 --port 9999
ghostshell connect --host 127.0.0.1 --port 9999

Python Usage

from ghostshell.core.server import RemoteServer
from ghostshell.core.client import RemoteClient

server = RemoteServer("0.0.0.0", 9999)
server.start()

client = RemoteClient("127.0.0.1", 9999)
client.connect()

print(client.send_command("whoami"))
client.close()

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ghostshell-1.0.1.tar.gz (1.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ghostshell-1.0.1-py3-none-any.whl (2.1 kB view details)

Uploaded Python 3

File details

Details for the file ghostshell-1.0.1.tar.gz.

File metadata

  • Download URL: ghostshell-1.0.1.tar.gz
  • Upload date:
  • Size: 1.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for ghostshell-1.0.1.tar.gz
Algorithm Hash digest
SHA256 075a4be1683664cbee370fb0537fbf2223cb7ddf9c97db986dbd281ce196c7b1
MD5 b23a2e99a2e5aa6a24e85cc21ab03f28
BLAKE2b-256 fcd503d7b650493a54b1ffefd81e538b77db7074595c1c949c3ec4b94aa7cc50

See more details on using hashes here.

File details

Details for the file ghostshell-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: ghostshell-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 2.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for ghostshell-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ff1f48c89aa61ddc92574522fb397e1e2292890b6b55b553aeeb493c9e4f06af
MD5 70a5db9ad500903d5b44f4ef1dd12813
BLAKE2b-256 6da1af49e632420a789ad82925c53a78c6781cd274200fa0f26dfe560962d075

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page