Skip to content

Commit

Permalink
Merge pull request #64 from doronz88/refactor/README
Browse files Browse the repository at this point in the history
docs: improve README
  • Loading branch information
doronz88 authored Feb 16, 2022
2 parents eb49783 + 75efb33 commit 1af8cff
Showing 1 changed file with 14 additions and 6 deletions.
20 changes: 14 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,27 +5,35 @@

## Description

Simple RPC service providing an API for controlling every aspect of the target machine for automation purposes.

This project includes two components:
* Server binary written in C exposing a protocol to call native C functions for controlling every aspect of

* Server binary written in C exposing a protocol to call native C functions.
* Client written in Python3 to communicate with the server

Simple remote control process requiring a single executable to be uploaded and run on the remote host.
This executable then provides a protocol to call native C functions which makes it possible to control
every aspect of the connected machine.
The python client utilizes the ability to call native functions in order to provide APIs for different aspects:

For more information about the client which utilizes these abilities, please view its README here:
https://github.com/doronz88/rpc-project/tree/master/src/rpcclient
* Remote shell commands
* Filesystem management (APIs for `open()`, `read()`, etc...)
* Network management (WiFi scan, TCP connect, etc...)
* Darwin only:
* Multimedia automation (recording and playing)
* Preferences managemnent (remote manage CFPreference and SCPreferences)
* Process management (kill, list, query open FDs, etc...)

## Building C Server

macOS & Linux:

```shell
git clone [email protected]:doronz88/rpc-project.git
cd src/rpcserver
make
```

On iOS:

```shell
git clone [email protected]:doronz88/rpc-project.git
cd src
Expand Down

0 comments on commit 1af8cff

Please sign in to comment.