README.md

In marcosci/deviz: Track and visualize mouse movement

deviz

/dɪˈvaɪz/ (device + vizualisation)

Input device tracking and visualization in R

🖱️ + ⌨️   tracking and visualization in R. deviz wraps the the python package pynput, which allows us to collect the mouse movement and keyboard strokes data.

Installation

You can install the development version from GitHub with:

# install.packages("devtools")
devtools::install_github("marcosci/deviz")

Example

Mouse

Mouse movement tracking

If you want to track your mouse, just run:

library(deviz)
mouse_df <- track_mouse("00h00m90s")

… this will track your mouse for 90 seconds, but also block your R console. If you use RStudio, the most convienent way to track your mouse movement with deviz is to run track_mouse("00h00m90s", as_job = TRUE). This launches the function as an RStudio job, which at its end returns a mouse_df object with the tracked data.

The returned contains information about the type of mouse input (movement, click, scroll) and further information about the specific event:

mouse_df
#> # A tibble: 14,251 x 8
#>    type      x     y button pressed dx    dy    date               
#>    <chr> <dbl> <dbl> <chr>  <chr>   <chr> <chr> <dttm>             
#>  1 Click  107. 1047. left   False   <NA>  <NA>  2021-01-10 14:45:46
#>  2 Move   108. 1047. <NA>   <NA>    <NA>  <NA>  2021-01-10 14:45:47
#>  3 Move   108. 1047. <NA>   <NA>    <NA>  <NA>  2021-01-10 14:45:47
#>  4 Move   109. 1047. <NA>   <NA>    <NA>  <NA>  2021-01-10 14:45:47
#>  5 Move   110. 1047. <NA>   <NA>    <NA>  <NA>  2021-01-10 14:45:47
#>  6 Move   110. 1047. <NA>   <NA>    <NA>  <NA>  2021-01-10 14:45:47
#>  7 Move   111. 1047. <NA>   <NA>    <NA>  <NA>  2021-01-10 14:45:47
#>  8 Move   113. 1047. <NA>   <NA>    <NA>  <NA>  2021-01-10 14:45:47
#>  9 Move   114. 1047. <NA>   <NA>    <NA>  <NA>  2021-01-10 14:45:47
#> 10 Move   115. 1047. <NA>   <NA>    <NA>  <NA>  2021-01-10 14:45:47
#> # … with 14,241 more rows

Visualize mouse movement

visualize_mouse(mouse_df, type = "dot")

Keyboard

Keyboard strokes tracking

Equivalent to the way we can track mouse movement, we can track the key strokes in a given time interval:

library(deviz)
key_df <- track_keyboard("00h00m90s")

There is also the possibility to run this command as an RStudio Job.

Visualize mouse movement

visualize_keyboard(key_df)

Code of Conduct

Please note that the deviz project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

marcosci/deviz documentation built on Jan. 17, 2021, 1:14 a.m.