{"id":16072605,"url":"https://github.com/b0o/swaynagmode","last_synced_at":"2025-07-24T15:38:46.533Z","repository":{"id":35922877,"uuid":"195307031","full_name":"b0o/swaynagmode","owner":"b0o","description":"⌨ swaynag wrapper for the love of keybindings","archived":false,"fork":false,"pushed_at":"2022-01-30T13:11:12.000Z","size":31,"stargazers_count":47,"open_issues_count":1,"forks_count":2,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-19T07:03:39.766Z","etag":null,"topics":["i3","i3wm","nag","sway","sway-nag","swaynag","swaywm","wayland"],"latest_commit_sha":null,"homepage":"https://aur.archlinux.org/packages/swaynagmode","language":"Shell","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/b0o.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"b0o","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2019-07-04T22:26:55.000Z","updated_at":"2025-03-01T17:12:09.000Z","dependencies_parsed_at":"2022-08-08T12:16:49.808Z","dependency_job_id":null,"html_url":"https://github.com/b0o/swaynagmode","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0o%2Fswaynagmode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0o%2Fswaynagmode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0o%2Fswaynagmode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0o%2Fswaynagmode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/b0o","download_url":"https://codeload.github.com/b0o/swaynagmode/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245385434,"owners_count":20606648,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["i3","i3wm","nag","sway","sway-nag","swaynag","swaywm","wayland"],"created_at":"2024-10-09T08:01:25.728Z","updated_at":"2025-03-25T02:31:14.604Z","avatar_url":"https://github.com/b0o.png","language":"Shell","funding_links":["https://github.com/sponsors/b0o"],"categories":["Shell"],"sub_categories":[],"readme":"swaynagmode\n-----------\n```\nswaynagmode\nv0.2.1\ngithub.com/b0o/swaynagmode\n\nA wrapper script which provides programmatic control\nover swaynag, intended for use with keyboard bindings.\n\nTo create a nag, simply use swaynag options as normal - they will be parsed and passed through.\n\nTo customise a nag, use these additional options:\n\n  short      long           description\n  -M \u003cmode\u003e  --mode         name of sway mode to trigger on init (default: nag)\n                            NOTE: beginning in sway version 1.2, mode names are case-sensitive\n  -D \u003cmode\u003e  --mode-default name of sway mode to trigger on exit (default: default)\n             --no-mode      disable triggering of sway modes\n  -i \u003cindex\u003e --initial      index of the initially selected button (default: 0)\n  -K         --no-kill      don't add a kill command to the button actions\n  -R         --reverse      reverse the button order\n\nTo control an existing nag, use the following options:\n\n  short           long       description\n  -x              --exit     dismisses the nag without performing any actions\n  -S \u003cprev|next\u003e  --select   selects the previous/next button, wrapping around each end\n                             (as specified in arguments left to right, buttons appear from right to\n                             left)\n  -C              --confirm  accepts the selected button (indicated with [brackets]) and executes its\n                             action.\n\nGlobal options:\n  short  long       description\n  -h     --help     display usage information for swaynagmode and swaynag\n  -H     --help-snm display usage information for swaynagmode\n  -v     --version  output version\n\nCaveats:\n  - Only one instance of swaynagmode may be run at a time.\n\nExample sway configuration:\n\n  # nag\n  set {\n    $nag         exec swaynagmode\n    $nag_exit    $nag --exit\n    $nag_confirm $nag --confirm\n    $nag_select  $nag --select\n  }\n  mode \"nag\" {\n    bindsym {\n      Ctrl+d    mode \"default\"\n\n      Ctrl+c    $nag_exit\n      q         $nag_exit\n      Escape    $nag_exit\n\n      Return    $nag_confirm\n\n      Tab       $nag_select prev\n      Shift+Tab $nag_select next\n\n      Left      $nag_select next\n      Right     $nag_select prev\n\n      Up        $nag_select next\n      Down      $nag_select prev\n    }\n  }\n  bindsym {\n    $super+Shift+q $nag -t \"warning\" -m \"Exit Sway?\" -b \"Exit\" \"swaymsg exit\" -b \"Reload\" \"swaymsg reload\"\n  }\n  # -R is recommended for swaynag_command so that, upon a syntax error in your sway config, the\n  # 'Reload Sway' option will be initially selected instead of the 'Exit Sway' option\n  swaynag_command $nag -R\n\n\n(c) 2019-2021 Maddison Hellstrom \u003cgithub.com/b0o\u003e\n\nGPL License (https://www.gnu.org/licenses/gpl-3.0.txt)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fb0o%2Fswaynagmode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fb0o%2Fswaynagmode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fb0o%2Fswaynagmode/lists"}