{"Package":"screenshot","Type":"Package","Title":"Take Screenshots (Screen Capture) from R Command","Version":"0.9.2","Authors@R":"person(\"Toshikazu\", \"Matsumura\", ,\n\"matutosi@gmail.com\", role = c(\"aut\", \"cre\"),\ncomment = c(ORCID = \"0000-0003-2306-6355\"))","Description":"Take screenshots from R command and locate an image position.","RoxygenNote":"7.3.2","URL":"https://github.com/matutosi/screenshot,\nhttps://matutosi.github.io/screenshot/","License":"MIT + file LICENSE","Encoding":"UTF-8","LazyData":"true","Imports":"dplyr, fs, imager, magick, purrr, rlang, stringr, tibble,\nutils","Suggests":"knitr, rmarkdown, spelling, testthat (>= 3.0.0)","Config/testthat/edition":"3","Language":"en-US","Depends":"R (>= 4.1.0)","NeedsCompilation":"no","Packaged":"2025-08-27 03:33:40 UTC; matutosi","Author":"Toshikazu Matsumura [aut, cre] (ORCID:\n)","Maintainer":"Toshikazu Matsumura ","Repository":"CRAN","Date/Publication":"2025-08-27 03:50:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/screenshot_0.9.2.tar.gz","jsonAuthors":[{"name":"Toshikazu Matsumura","email":"matutosi@gmail.com","maintainer":true}],"readme":"\n\n\n# screenshot\n\n\n\n\n\nThe goal of screenshot is to take a screenshot easily and locate image\nposition on a display with R.\n\n## Installation\n\nYou can install the development version from\n[GitHub](https://github.com/) with:\n\n``` r\n # install.packages(\"remotes\")\nremotes::install_github(\"matutosi/screenshot\")\ninstall.packages(\"screenshot\") # You can also install from CRAN:\n```\n\nOn Windows, need to install screenshot.exe by `install_screenshot()`.\nThis exe file is compiled from codes shown below.\n\n\n\n``` r\nlibrary(screenshot)\n # required on win\ninstall_screenshot()\n # if you want to install another directory\n # bin_dir <- \"SET_YOUR DIRECTORY\"\n # install_screenshot(bin_dir)\n```\n\nOn Mac `screencapture` is usually available.\n\nOn Linux GNOME desktop use `gnome-screenshot`. If not installed, run\n`sudo apt install gnome-screenshot`.\n\n## Example\n\nYou can use `screenshot()` to take a screenshot easily.\n\n``` r\nlibrary(screenshot)\nsc <- screenshot()\nsc_image <- imager::load.image(sc)\nplot(sc_image)\n```\n\nTo locate image from a screenshot, use `locate_image()`. In this case,\nbottom left corner of screenshot image was cut off as needle image.\n\n``` r\nsc <- screenshot()\nsc_image <- imager::load.image(sc)\nw <- 100\nh <- 80\npos_x <- 1\npos_y <- imager::height(sc_image) - h\nneedle <- hay2needle(sc_image, pos_x, pos_y, w, h)\n(locate_image(needle)) # center location\npos <- locate_image(needle, center = FALSE)\nfound <- hay2needle(sc_image, pos[1], pos[2], w, h)\nlayout(c(1:3))\nplot(sc_image)\nplot(needle)\nplot(found)\n```\n\nOn Windows, clipboard image can be saved by `save_clipboard_image()`.\n\n``` r\npath_img <- \"path_of_png_file\"\nsave_clipboard_image(path_img)\nshell.exec(path_img)\n```\n\n## Caution (=0.9.0)\n\n- Automatically adjusted in 0.9.1 and latter.\n\nWhen changing display DPI scaling, need to adjust position.\n\n``` r\n # when using 125%\npos <- locate_image(IMAGE_TO_CLICK) / 1.25\nKeyboardSimulator::mouse.move(pos[1], pos[2])\nKeyboardSimulator::mouse.click()\n```\n\nYou can see display scale in setting app as shown below.\n\n

\n\n## Citation\n\nToshikazu Matsumura (2023) screenshot. Screenshot and locate image\nEasily. .","jobInfo":{"package":"screenshot","version":"0.9.2","parsingStatus":"success","parserVersion":2,"parsedAt":"2025-08-27T06:30:00+0000"}}

Description

Usage

Arguments

Value

Examples