Metadata-Version: 2.1
Name: sendevent_getevent_keyboard
Version: 0.10
Summary: ADB sendevent - press multiple keys at the same time, control the duration of each event!
Home-page: https://github.com/hansalemaos/sendevent_getevent_keyboard
Author: Johannes Fischer
Author-email: <aulasparticularesdealemaosp@gmail.com>
License: MIT
Keywords: bluestacks,adb,keystrokes,keys,getevent,sendevent
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Editors :: Text Processing
Classifier: Topic :: Text Processing :: General
Classifier: Topic :: Text Processing :: Indexing
Classifier: Topic :: Text Processing :: Filters
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
License-File: LICENSE.rst


# ADB sendevent - press multiple keys at the same time, control the duration of each event!



<img src="https://github.com/hansalemaos/screenshots/raw/main/sendevent_key.png"/>





Take a look at the video to see what the code below does:

[![YT](https://github.com/hansalemaos/screenshots/raw/main/sendevent_key_video.png)](https://youtu.be/GO2XsvI6TZk)

[https://www.youtube.com/watch?v=GO2XsvI6TZk]()





```python

$pip install sendevent-getevent-keyboard



from time import sleep

from sendevent_getevent_keyboard import SendEventKeystrokes



sendeventkey = SendEventKeystrokes(

    adb_path="C:\\Users\\Gamer\\AppData\\Local\\Android\\Sdk\\platform-tools\\adb.exe",

    deviceserial="localhost:5735",

    sdcard="/storage/emulated/0/",  # it is probably better to pass the path than the symlink

    tmp_folder_on_sd_card="AUTOMAT",  # The folder will be created if it doesn't exist. All temp files will be stored there

    exit_keys="ctrl+x",  # If you want to interrupt adb

)



sendeventkey.connect_to_adb()



sleep(3)

# KEY_LEFTSHIFT + KEY_1 will result in "!" / Pass as many keys as you want. You can see a complete list by calling:

# SendEventKeystrokes.show_all_letter_codes() Keys on the left will get some additional execution time.

sendeventkey.press_multiple_keys_at_the_same_time(

    keylist=["KEY_LEFTSHIFT", "KEY_1"], time_to_press=0.5

)



# For the method SendEventKeystrokes.write_text() only these keys are available:

# https://android.googlesource.com/platform/external/kernel-headers/+/8bc979c0f7b0b30b579b38712a091e7d2037c77e/original/uapi/linux/input.h

# If there are special characters, like ä/ö/ü, they will be normalized before sending the keystrokes. (ä - a / ü - u / ö - o)

# Characters will be sent as lower case. Using this method, you cannot send upper case letters.

sendeventkey.write_text(

    textlist=["Hi my friend, how are you", "ENTER"],

    speed=4,  # used for the chunk calculation (or how many sendevents are passed at the time)

    nosleep=False,  # if False, there will be no sleep between sending the letter chunks

    add_to_sleep_time=(0.01, 0.05),  # random sleep range

)

sleep(3)

sendeventkey.press_key_for_certain_time(

    ("a", 2), ("b", 1), ("c", 1), ("d", 0)

)  # pass as many tuples as you want, you can see all available keys by calling SendEventKeystrokes.show_all_letter_codes()

sleep(3)





# If you want to repeat the same action over and over again, create a DataFrame, this will save a little bit of time for future executions

df = sendeventkey.get_keystrokes_df_for_text(

    textlist=["text to reuse", "right", "ENTER"],

    speed=4,  # "right" and "ENTER" are not interpreted as text, but as control keys

)

# Execute the keystrokes By the way: if nosleep is True, add_to_sleep_time will be ignored

sendeventkey.write_text_df(df, nosleep=True, add_to_sleep_time=(1, 2))





"""

sendeventkey.show_all_letter_codes()

                     0                   1                     2                     3                  4

0            ABS_BRAKE             ABS_GAS             ABS_HAT0X             ABS_HAT0Y  ABS_MT_POSITION_X

1    ABS_MT_POSITION_Y              ABS_RZ                 ABS_X                 ABS_Y              ABS_Z

2             BTN_EAST         BTN_GAMEPAD             BTN_MOUSE             BTN_NORTH         BTN_SELECT

3            BTN_START          BTN_THUMBL            BTN_THUMBR                BTN_TL            BTN_TL2

4               BTN_TR             BTN_TR2              BTN_WEST                 KEY_0              KEY_1

5            KEY_102ND               KEY_2                 KEY_3                 KEY_4              KEY_5

6                KEY_6               KEY_7                 KEY_8                 KEY_9              KEY_A

7       KEY_APOSTROPHE               KEY_B              KEY_BACK         KEY_BACKSLASH      KEY_BACKSPACE

8        KEY_BOOKMARKS               KEY_C              KEY_CALC          KEY_CAPSLOCK          KEY_COMMA

9          KEY_COMPOSE        KEY_COMPUTER                 KEY_D            KEY_DELETE            KEY_DOT

10            KEY_DOWN               KEY_E               KEY_END             KEY_ENTER          KEY_EQUAL

11             KEY_ESC               KEY_F                KEY_F1               KEY_F10            KEY_F11

12             KEY_F12             KEY_F13               KEY_F14               KEY_F15             KEY_F2

13              KEY_F3              KEY_F4                KEY_F5                KEY_F6             KEY_F7

14              KEY_F8              KEY_F9           KEY_FORWARD                 KEY_G          KEY_GRAVE

15               KEY_H         KEY_HANGEUL             KEY_HANJA            KEY_HENKAN       KEY_HIRAGANA

...

"""



# most of the keystrokes can be executed easily because almost all of them have their method.

# You only have to pass the duration when calling them



sendeventkey.press_dev_input_event10_u(2)  # Will press the button for 2 seconds

dir(sendeventkey)

# ....

# 'press_dev_input_event10_tr2',

# 'press_dev_input_event10_u',

# 'press_dev_input_event10_up',

# 'press_dev_input_event10_v',

# 'press_dev_input_event10_volumedown',

# 'press_dev_input_event10_volumeup',

# 'press_dev_input_event10_w',

# 'press_dev_input_event10_wakeup',

# 'press_dev_input_event10_west',

# 'press_dev_input_event10_x',

# 'press_dev_input_event10_y',

# 'press_dev_input_event10_yen',

# 'press_dev_input_event10_z',

# 'press_dev_input_event10_zenkakuhankaku',

# 'press_dev_input_event11_a',

# 'press_dev_input_event11_abs_brake',

# 'press_dev_input_event11_abs_gas',

# 'press_dev_input_event11_abs_hat0x',

# 'press_dev_input_event11_abs_hat0y',

# 'press_dev_input_event11_abs_mt_position_x',

# 'press_dev_input_event11_abs_mt_position_y',

# 'press_dev_input_event11_abs_rz',

# 'press_dev_input_event11_abs_x',

# 'press_dev_input_event11_abs_y',

# 'press_dev_input_event11_abs_z',

# 'press_dev_input_event11_apostrophe',

# 'press_dev_input_event11_b',

# 'press_dev_input_event11_back',

# 'press_dev_input_event11_backslash',

# 'press_dev_input_event11_backspace',

# ....





```



### Tested against Windows 10 / Python 3.9.13 / BlueStacks 5



It should also work with any rooted Android device, but 

since my cell phone is not rooted, and I have no intention of rooting it, 

I cannot test the module against a physical Android device.

(I would be grateful for any feedback)



