Skip to content

Commit

Permalink
Increased Readability
Browse files Browse the repository at this point in the history
Fixed spelling and Increased readability
  • Loading branch information
DanBrown47 authored Nov 6, 2019
1 parent 6de7014 commit 87f3ef8
Showing 1 changed file with 19 additions and 18 deletions.
37 changes: 19 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,31 @@
I'm in progress internationalization,Welcome your to join.
'm in progress internationalization, Welcome to join.

androrat (Fork/Silent Edition)
Androrat (Fork/Silent Edition)

Remote Administration Tool for Android

Androrat is a client/server application developed in Java Android for the client side and in Java/Swing for the Server.
Androrat is a client/server application developed in Java Android for the client-side and in Java/Swing for the Server.

> The name Androrat is a mix of Android and RAT (Remote Access Tool).
It has been developed in a team of 4 for a university project. It has been realised in one month. The goal of the application is to give the control of the android system remotely and retrieve informations from it.
It has been developed in a team of 4 for a university project. It has been realized in one month. The goal of the application is to give control of the android system remotely and retrieve pieces of information from it.

# Technical matters

* The android application is the client for the server which receive all the connections.
* The android application run as a service(not an activity) that is started during the boot. So the user does not need to interact with the service (Even though there is a debug activity that allow to configure the IP and the port to connect to).
* The connection to the server can be triggered by a SMS or a call (this can be configured)
* The android application is the client for the server which receives all the connections.
* The android application runs as a service(not an activity) that is started during the boot. So the user does not need to interact with the service (Even though there is a debug activity that allows configuring the IP and the port to connect to).
* The connection to the server can be triggered by an SMS or a call (this can be configured)

### All the available functionalities are

* Get contacts (and all theirs informations)
* Get contacts (and all their pieces of information)
* Get call logs
* Get all messages
* Location by GPS/Network
* Monitoring received messages in live
* Monitoring phone state in live (call received, call sent, call missed..)
* Monitoring phone state in life (call received, call sent, call missed..)
* Take a picture from the camera
* Stream sound from microphone (or other sources..)
* Stream sound from the microphone (or other sources..)
* Streaming video (for activity based client only)
* Do a toast
* Send a text message
Expand All @@ -39,28 +39,28 @@ The project contains the following folders:

* doc: Will soonly contain all the documentation about the project
* Experiment: Contain an *experimental* version of the client articulated around an activity wish allow by the way to stream video
* src/Androrat: Contain the source code of the client that should be put on the android plateform
* src/AndroratServer: Contain the sources of the Java/Swing server that can be run on any plateform
* src/Androrat: Contain the source code of the client that should be put on the android platform
* src/AndroratServer: Contain the sources of the Java/Swing server that can be run on any platform
* src/api: Contain all the different api used in the project (JMapViewer for the map, forms for swing, and vlcj for video streaming)
* src/InOut: Contain the code of the content common for the client and the server which is basically the protocol implementation

# Screenshots

## Main GUI

This is the main GUI where all the clients connected appears. The list is dynamically updated when a new client connects or is disconnected. Moreover a log of all connections and global informations are showed in the log panel at the bottom of the window. A simple double-click on a client open his window to interact with him.
This is the main GUI where all the clients connected appears. The list is dynamically updated when a new client connects or is disconnected. Moreover, a log of all connections and global Information are shown in the log panel at the bottom of the window. A simple double-click on a client opens his window to interact with him.

![Main GUI](https://raw.github.com/wszf/androrat/master/doc/main.png)

## Client Panel

All the actions with client can be made in the client window which is articulated around tabs. The default tab is called Home and provide various functionalities. First as we can see in the left scrollview all the informations about the client like sim infos, battery infos, network infos, sensors infos etc. On the right there is the options which allow remotely to change the configuration of the client like the ip and port to connect to, either or not wait a trigger to intent server connection etc. Finally quick actions can be perfomed in this tab like a toast message, do vibrate the phone or open an URL.
All the actions with a client can be made in the client window which is articulated around tabs. The default tab is called Home and provide various functionalities. First, as we can see in the left scroll view all the information about the client like sim Infos, battery Infos, network Infos, sensors Infos etc. On the right, there are the options that allow remotely to change the configuration of the client like the ip and port to connect to, either or not wait for a trigger to intent server connection etc. Finally, quick actions can be performed in this tab like a toast message, do vibrate the phone or open an URL.

![Client Panel](https://raw.github.com/wszf/androrat/master/doc/homepanel.png)

## Other tabs

The two screenshots below shows two others tabs for two functionalities which are respectively get contacts and geolocation. As you can see on the get contacts panel the list on the left show all contacts the name, the phone number and the picture if available. Morevover on the right three buttons allow to get more information about the selected contact send him a sms or call him. For Geolocation we can choose our provider either GPS either network that use google to locate. Then the streaming can be started and the map will be updated as soon as data has been received.
The two screenshots below show two other tabs for two functionalities which are respectively getting contacts and geolocation. As you can see on the get contacts panel the list on the left shows all contacts the name, the phone number and the picture if available. Moreover on the right three buttons allows getting more information about the selected contact to send him a SMS or call him. For Geolocation, we can choose our provider either GPS either network that uses google to locate. Then the streaming can be started and the map will be updated as soon as data has been received.

![Contacts](https://raw.github.com/wszf/androrat/master/doc/contact.png)

Expand All @@ -69,10 +69,11 @@ The two screenshots below shows two others tabs for two functionalities which ar
Use Notes

* You will need the Android SDK and Eclipse to compile this project.
* Command & Control Application is cross platform Java, tested fine on OSX, Linux and Windows
* Command & Control Application is cross-platform Java, tested fine on OSX, Linux and Windows
* You need to edit /src/Androrat/src/my/app/client/LauncherActivity.java before compiling the APK.
* This is where you hardcode the listeners IP and Port. You can use an IP, or a domain name like a dyndns.
* On certain mobile devices it drains battery fast. Be aware of this.
* This is where you hardcode the listeners IP and Port. You can use an IP, or a domain name like a DNS.
* On certain mobile devices, it drains the battery fast. Be aware of this.

Note: I am not the author of this software, it is forked and slightly edited. I may make changes to it to fix bugs as I go along, but I am not a java programmer at heart, and only have this here for my own use in testing.


0 comments on commit 87f3ef8

Please sign in to comment.