{"id":33914356,"url":"https://github.com/spitulax/gripper","last_synced_at":"2026-06-03T19:31:26.866Z","repository":{"id":242402092,"uuid":"804477827","full_name":"spitulax/gripper","owner":"spitulax","description":"Simple and easy to use screenshot utility for Wayland","archived":false,"fork":false,"pushed_at":"2025-01-12T20:57:07.000Z","size":195,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-12T21:31:45.699Z","etag":null,"topics":["c","hyprland","screenshot","sway","wayland"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spitulax.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-22T17:00:01.000Z","updated_at":"2025-01-12T20:57:11.000Z","dependencies_parsed_at":"2024-06-02T20:14:27.784Z","dependency_job_id":"91201a95-f9d9-484c-93ac-8fb1a014b79d","html_url":"https://github.com/spitulax/gripper","commit_stats":null,"previous_names":["spitulax/gripper"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/spitulax/gripper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spitulax%2Fgripper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spitulax%2Fgripper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spitulax%2Fgripper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spitulax%2Fgripper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spitulax","download_url":"https://codeload.github.com/spitulax/gripper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spitulax%2Fgripper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33876893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c","hyprland","screenshot","sway","wayland"],"created_at":"2025-12-12T06:26:38.754Z","updated_at":"2026-06-03T19:31:26.861Z","avatar_url":"https://github.com/spitulax.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eGripper\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eSimple and easy to use screenshot utility for Wayland\u003c/h4\u003e\n\nGripper is an alternative to [grimblast](https://github.com/hyprwm/contrib/blob/main/grimblast) and\n[grimshot](https://github.com/OctopusET/sway-contrib/blob/master/grimshot) that works for both\nHyprland and Sway.\n\nGripper runs [grim](https://sr.ht/~emersion/grim/) under the hood, but makes it easier to use by\nproviding \"aliases\" or shortcuts of common operations that are often compositor-specific. Also\ncopies captured image to clipboard and sends notification on completion by default.\n\n## Modes\n\nMode is a common screenshotting operation that is bundled into a single subcommand. Some modes are\ncompositor-specific such as `active-window`, but Gripper will run the correct command intended for\neach compositor respectively.\n\nThese are the modes that are implemented, these can be run as `gripper \u003cmode\u003e`:\n\n- `full`: Fullscreen (focused/selected monitor).\n- `region`: Select a region using slurp. The region selection is free if you hold and drag, but if\n  you use supported compositors it also has window snapping which highlights the window your cursor\n  is currently in and automatically select the region occupied by the window by just clicking on it.\n- `active-window`: Screenshot the window currently focused (needs supported compositor).\n- `last-region`: The region selected by previous execution of `region`, `active-window` and `custom`\n  mode.\n- `custom`: Specify the region to capture yourself.\n\n## Compositors\n\nGripper should run on compositors that [grim](https://sr.ht/~emersion/grim/) and\n[slurp](https://github.com/emersion/slurp) support.\n\nSome modes such as `active-window` require them to be implemented for specific compositor.\n\nSupported compositor means that some compositor-specific operations are implemented for that\ncompositor.\n\nSupported compositors for now:\n\n- Hyprland\n- Sway\n\n## Prerequisites\n\nMake sure the following commands are available. If you install Gripper with Nix, these are\nautomatically installed.\n\n- `grim`\n- `slurp`\n- `jq`\n- `wl-copy` (optional, for copying image to clipboard)\n- `notify-send` (optional, for notification)\n\nYou can check them with the program by running `gripper --check`.\n\n## Building\n\nGripper is written in pure C without any external libraries. Install `meson` then run these\ncommands:\n\n```\n$ meson setup build\n$ meson compile -C build\n$ ./build/gripper --help\n```\n\n### Nix (with Flake)\n\nSimply run the following commands.\n\n```\n$ nix build\n$ ./result/bin/gripper --help\n```\n\nAll the required programs should be available to Gripper but check if your notification daemon\nsupports sending notification through `notify-send`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspitulax%2Fgripper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspitulax%2Fgripper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspitulax%2Fgripper/lists"}