Skip to content

Commit

Permalink
Update README so that we can promote it widely
Browse files Browse the repository at this point in the history
You're wellcome!
  • Loading branch information
PenguinYang committed Mar 8, 2013
1 parent 3e05f9e commit 08fd270
Showing 1 changed file with 37 additions and 11 deletions.
48 changes: 37 additions & 11 deletions README
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@ Seven Sqaure

Android screencast wroted in QT. There is one in java? forget it from now on.

A tool used to view a mirror screen of your Android device on the PC,
used for demostration, debuging, and so on. even you can click on the
mirror screen as you touch on the touch panel.

Features:

Major:
Expand All @@ -11,9 +15,8 @@ Features:
* Virtual menu/home/back key on the UI
* Virtual QWERTY key support
* Auto connect to your device when plug in
* Auto turn screen on (wakeup) when connected
* Click on window to wakeup the device (emulate power key press event)
* Support both Android ICS and Jelly Bean. Froyo not tested.
* Support both Android ICS and Jelly Bean. Froyo not full tested.
* Wrote in Qt 4.x, easily port to different desktop environment

Minor:
Expand All @@ -32,32 +35,55 @@ Non-feature:
* Not support screen recording as video
* Not support screen shot as picture

Additional Key Map
==================

You can press F1/2/3/4 on you keyboard to emulate the following Android key.

F1 AKEYCODE_HOME
F2 AKEYCODE_BACK
F3 AKEYCODE_CALL
F4 AKEYCODE_ENDCALL

Pre-requirements
================

Mandatory:

* Android device in engineer mode (Rooted), So that you can get
root permission in adb shell
* Linux, any distribution with Qt package.

$> adb root
$> adb shell id
uid=0(root) gid=0(root)
* Qt 4.6+ installed in your system

* screencap command on the target device

* adb command is availible in your search path, check it:
$> adb shell ls /system/bin/screencap
/system/bin/screencap

If the output indicates: 'No such file or direcotry', you
can use the tool except install one by yourself.

the 'screencap' source code presents in frameworks/base/cmds/screencap.

* PC: adb command is availible in your search path, check it:

$> which adb
/usr/bin/adb

* USB cable connected to your android device
* Qt 4.6+ installed in your system

Optional:

* Android device in engineer mode (Rooted), So that you can get
root permission in adb shell

$> adb root
$> adb shell id
uid=0(root) gid=0(root)

* minigzip installed on your PC (For compressed image transfer)

There is a precompiled x86_64 minigzip binary in the top dir, just copy into
your system path:
There is a precompiled x86_64 minigzip binary in the contirbutes dir,
just copy into your system path:

$> sudo cp contributes/minigzip /usr/bin

Expand Down

0 comments on commit 08fd270

Please sign in to comment.