{"id":49021083,"url":"https://github.com/faetalize/waytator","last_synced_at":"2026-04-28T19:01:07.479Z","repository":{"id":350888043,"uuid":"1208652648","full_name":"faetalize/waytator","owner":"faetalize","description":"Wayland image annotation tool","archived":false,"fork":false,"pushed_at":"2026-04-24T09:11:50.000Z","size":317,"stargazers_count":20,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-24T11:39:33.034Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/faetalize.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-12T15:18:54.000Z","updated_at":"2026-04-24T09:11:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/faetalize/waytator","commit_stats":null,"previous_names":["faetalize/waytator"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/faetalize/waytator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faetalize%2Fwaytator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faetalize%2Fwaytator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faetalize%2Fwaytator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faetalize%2Fwaytator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faetalize","download_url":"https://codeload.github.com/faetalize/waytator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faetalize%2Fwaytator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32394478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T14:34:11.604Z","status":"ssl_error","status_checked_at":"2026-04-28T14:32:37.009Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-04-19T04:02:06.775Z","updated_at":"2026-04-28T19:01:07.473Z","avatar_url":"https://github.com/faetalize.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# waytator\n\n`waytator` is a screenshot annotator and lightweight image editor\n\n`niri` user? Check below on how to integrate niri screenshots with this tool\n\n\u003cp  align=\"center\"\u003e\n\u003cimg width=\"600\" alt=\"Screenshot from 2026-04-19 03-04-52\" src=\"https://github.com/user-attachments/assets/4bcc1c58-5834-4f35-877b-5f94a914d6ce\" /\u003e\n\u003c/p\u003e\n\u003cp  align=\"center\"\u003e\n\u003cimg width=\"600\" alt=\"image\" src=\"https://github.com/user-attachments/assets/91c949f3-f106-433f-a1d6-62742a72831d\" /\u003e\n\u003c/p\u003e\n\n## Build \u0026 Install\n\n### Arch\n\nGet it from the AUR:\n\n```bash\nyay -S waytator\n```\n\n### From source\n\n1) Required build dependencies:\n\n- `meson`\n- `ninja`\n- `pkg-config`\n- `gtk4`\n- `libadwaita-1`\n- a C compiler such as `gcc` or `clang`\n\n2) Recommended runtime dependency:\n\n- `tesseract` for OCR support\n- `wl-clipboard` for niri screenshot clipboard support\n\n3) Install into `~/.local`:\n\n```bash\nmeson setup build --buildtype=release --prefix=\"$HOME/.local\" # Override the prefix if needed\nmeson compile -C build\nmeson install -C build\n```\n\nThis installs:\n\n- the `waytator` binary to `${HOME}/.local/bin/waytator`\n- the desktop entry to `${HOME}/.local/share/applications/dev.faetalize.waytator.desktop`\n- the app icon to `${HOME}/.local/share/icons/hicolor/scalable/apps/dev.faetalize.waytator.svg`\n\nThe app's identifier is `dev.faetalize.waytator` for concerns such as the desktop entry and icon, so if you have an older version of the app installed with a different identifier (e.g. `dev.waytator.Waytator`), make sure to remove it first to avoid conflicts.\n\n\nIf `~/.local/bin` is not already on your `PATH`, add it in your shell profile. For example, add the following line to `~/.bashrc`:\n\n```bash\nexport PATH=\"$HOME/.local/bin:$PATH\"\n```\n\nIf launchers fail to start `waytator` after installing from source, make sure your graphical session includes `~/.local/bin` in `PATH`, not just your shell configuration.\n\n## Usage\n\nRead from stdin automatically when image data is piped in:\n\n```bash\ngrim -g \"$(slurp)\" - | waytator\n```\n\nOr pass stdin explicitly:\n\n```bash\ngrim -g \"$(slurp)\" - | waytator --stdin\n```\n\nSet the default display/save-as name for stdin images:\n\n```bash\ngrim -g \"$(slurp)\" - | waytator --stdin --name \"Screenshot.png\"\n```\n\nOpen an existing image:\n\n```bash\nwaytator path/to/image.png\n```\n\nIt can also be run independently:\n\n```bash\nwaytator\n```\n\nIf you're on niri, just bind your screenshot keybind to `./scripts/screenshot-to-waytator.sh`, this will automatically open screenshots into `waytator` after they are captured for editing. Saving from niri's screenshot UI opens the saved file; pressing `Ctrl+C` in the screenshot UI opens the copied image directly from the clipboard. Clipboard captures use a timestamped name by default; override it with `WAYTATOR_SCREENSHOT_NAME`.\n\n```kdl\n// in your config.kdl, in the binds section\nPrint { spawn \u003cpath-to-screenshot-to-waytator.sh\u003e; }\nMod+Shift+S { spawn \u003cpath-to-screenshot-to-waytator.sh\u003e; }\n```\n\nI recommend adding a window rule to float `waytator` windows for better experience, for example with `niri`:\n\n```kdl\n// in your config.kdl\nwindow-rule {\n    match app-id=r#\"^dev\\.faetalize\\.waytator$\"#\n    open-floating true\n}\n```\n\n## License\n\nGPL-3.0-or-later.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaetalize%2Fwaytator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaetalize%2Fwaytator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaetalize%2Fwaytator/lists"}