Skip to main content

Android getevent for Humans!

Project description

Android's getevent for Humans!

Tested against Windows 10/ Python 3.11 / Anaconda

pip install geteventforhumans

YT https://www.youtube.com/watch?v=np2KZXZHzsY

The function start_getevent_for_humans in the module is designed to capture and log Android device input events in a human-readable format. 

adb_path (optional, default: None):
Type: str
Description: The file path to the Android Debug Bridge (ADB) executable. If not specified, the function attempts to locate ADB using the system's environment variables.

logfolder (optional, default: None):
Type: str
Description: The directory path where event logs should be saved. If not specified, the logs will not be saved

device_serial (optional, default: '127.0.0.1:5555'):
Type: str
Description: The serial number of the Android device to be monitored. This is crucial when multiple devices are connected to the ADB host.

runasdaemon (optional, default: True):
Type: bool
Description: If set to True, the threads started by this function will run as daemons, allowing the main program to exit without having to manually terminate these threads.

bufsize (optional, default: 0):
Type: int
Description: The buffer size for reading data from the input streams. This size can impact performance and responsiveness in capturing event data.

shell (optional, default: True):
Type: bool
Description: Specifies whether the subprocesses should be invoked within a shell environment. 

multiply (optional, default: 24):
Type: int
Description: Used as a multiplier in calculating the chunk size for data processing in some contexts. The exact usage should be confirmed within specific subprocess or threading implementations.


keepbuffer (optional, default: 4):
Type: int
Description: Determines the number of chunks to keep in memory buffer for processing, affecting how much past event data is accessible at any time.


ljust (optional, default: 12):
Type: int
Description: Specifies the padding length for string formatting within the logging output, ensuring alignment in log visualizations.


devices_to_observe (optional, default: empty tuple ()):
Type: tuple of str
Description: A tuple containing the identifiers of specific input devices to monitor, e.g., ("event3", "event4"). If empty, the script may default to monitoring all available devices.

Usage Example
To initiate the event monitoring for specific devices with custom settings, you might call the function like this:

from geteventforhumans import start_getevent_for_humans
import shutil

start_getevent_for_humans(
    adb_path=shutil.which("adb"),
    device_serial="127.0.0.1:5645",
    logfolder="c:\\neuelogsadb",
    runasdaemon=True,
    bufsize=0,
    shell=False,
    multiply=24,
    keepbuffer=1,
    ljust=12,
    devices_to_observe=("event3", "event4"),
)

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

geteventforhumans-0.10.tar.gz (15.1 kB view details)

Uploaded Source

Built Distribution

geteventforhumans-0.10-py3-none-any.whl (16.4 kB view details)

Uploaded Python 3

File details

Details for the file geteventforhumans-0.10.tar.gz.

File metadata

  • Download URL: geteventforhumans-0.10.tar.gz
  • Upload date:
  • Size: 15.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for geteventforhumans-0.10.tar.gz
Algorithm Hash digest
SHA256 56eae493a0992906a5dc86fea84663140926dc6e6d167288f2082187d4e85f87
MD5 69c6d69d0dc2e0942977ec368af6b4d6
BLAKE2b-256 7c0d4371c18b1b21833f84eab8789b5c54dc2495065bbf11178dacd9ac5a3185

See more details on using hashes here.

File details

Details for the file geteventforhumans-0.10-py3-none-any.whl.

File metadata

File hashes

Hashes for geteventforhumans-0.10-py3-none-any.whl
Algorithm Hash digest
SHA256 fb5f9afa459752e01ba634e81aab47f3bce52d617834380e7b2aaec17f7574a8
MD5 a743f0f9f753b4cbb13fce620e28b614
BLAKE2b-256 fb0ce2f0a1b01857eec835d97d4d5ee027ef5044625299ac8ee194cdb774d69b

See more details on using hashes here.

Supported by

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