{"id":13596102,"url":"https://github.com/zsh-users/zaw","last_synced_at":"2025-04-04T10:09:25.168Z","repository":{"id":50269371,"uuid":"1398165","full_name":"zsh-users/zaw","owner":"zsh-users","description":"zsh anything.el-like widget.","archived":false,"fork":false,"pushed_at":"2023-08-05T22:37:22.000Z","size":176,"stargazers_count":576,"open_issues_count":13,"forks_count":67,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-03-28T09:09:02.749Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zsh-users.png","metadata":{"files":{"readme":"README.rst","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}},"created_at":"2011-02-22T16:00:05.000Z","updated_at":"2025-03-17T00:03:52.000Z","dependencies_parsed_at":"2022-09-24T10:01:14.675Z","dependency_job_id":"a84f911b-30c5-4d47-87b2-37f5f53330e4","html_url":"https://github.com/zsh-users/zaw","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zsh-users%2Fzaw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zsh-users%2Fzaw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zsh-users%2Fzaw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zsh-users%2Fzaw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zsh-users","download_url":"https://codeload.github.com/zsh-users/zaw/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247157283,"owners_count":20893220,"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":[],"created_at":"2024-08-01T16:02:08.192Z","updated_at":"2025-04-04T10:09:25.148Z","avatar_url":"https://github.com/zsh-users.png","language":"Shell","funding_links":[],"categories":["Plugins","Shell"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"readme":"=================================\nzaw - zsh anything.el-like widget\n=================================\n\ninstall\n=======\n\n::\n\n  $ git clone git://github.com/zsh-users/zaw.git\n  remote: Counting objects: 136, done.\n  remote: Compressing objects: 100% (86/86), done.\n  remote: Total 136 (delta 43), reused 136 (delta 43)\n  Receiving objects: 100% (136/136), 23.68 KiB, done.\n  Resolving deltas: 100% (43/43), done.\n  $ echo \"source ${PWD}/zaw/zaw.zsh\" \u003e\u003e ~/.zshrc\n\nand restart zsh or manualy source ``zaw.zsh``.\n\n\nusage\n=====\n\n1. Trigger `zaw` by pressing ``Ctrl-x ;`` (``^x;``).\n2. select `source` and press ``enter``.\n3. filter items with zsh patterns separated by spaces, use ``^N``, ``^P`` and select one.\n4. execute action by pressing enter key or press ``Meta-enter`` for alternative action.\n\n   instead, press tab key and select action you want to execute.\n\n\nsources\n=======\n\ncurrently these sources are available:\n\n- aliases\n- applications\n- bookmark\n- cdr (needs cdr enabled.  Google it or use `this packaged version \u003chttps://github.com/willghatch/zsh-cdr\u003e`_)\n- commands\n- command-output\n- fasd\n- fasd-directories\n- fasd-files\n- functions\n- git-branches\n- git-recent-all-branches\n- git-recent-branches\n- git-files\n- git-files-legacy\n- git-log\n- git-reflog\n- git-status\n- history\n- locate\n- open-file\n- perldoc\n- process\n- programs\n- screens\n- searcher (ag/ack)\n- ssh-hosts\n- tmux\n- widgets\n\n(Note: git-files-legacy is an alternative for git-files.\ngit-files classifies modified files, git-files-legacy doesn't do it for\nperformance reason.)\n\nAdditional sources can be installed as third-party plugins.  Here is a list of all\nthe ones we know about.  Please let us know about any more you find or make!\nInstallation is easiest with a plugin manager such as \n`zgen \u003chttps://github.com/tarjoilija/zgen\u003e`_.  Otherwise you can just source the\n.zsh file that contains the source.\n\n- calibre source: https://github.com/junkblocker/calibre-zaw-source\n- MPD source: https://github.com/willghatch/zsh-zaw-mpd\n- `pass \u003chttp://www.passwordstore.org\u003e`_ source: https://gist.github.com/f440/9992963\n- systemd source: https://github.com/termoshtt/zaw-systemd\n- `todoman \u003chttps://github.com/hobarrera/todoman\u003e`_ source: https://github.com/willghatch/zsh-zaw-todoman\n\nshortcut widgets\n================\n\nzaw automaticaly create shortcut widgets for each sources\nthat directly access to the source.\n\nfor example, execute ``bindkey '^R' zaw-history`` and\npress ``^R`` to access history source.\n\nyou can get all available shortcut widgets' name using ``zaw-print-src``::\n\n  $ zaw-print-src\n  source name      shortcut widget name\n  ----------------------------------------\n  ack              zaw-ack\n  applications     zaw-applications\n  bookmark         zaw-bookmark\n  git-branches     zaw-git-branches\n  git-recent-all-branches     zaw-git-recent-all-branches\n  git-recent-branches     zaw-git-recent-branches\n  git-files        zaw-git-files\n  git-files-legacy zaw-git-files-legacy\n  git-status       zaw-git-status\n  history          zaw-history\n  open-file        zaw-open-file\n  perldoc          zaw-perldoc\n  process          zaw-process\n  screens          zaw-screens\n  ssh-hosts        zaw-ssh-hosts\n  tmux             zaw-tmux\n  fasd             zaw-fasd\n  fasd-directories zaw-directories\n  fasd-files       zaw-files\n\n\nkey binds and styles\n====================\n\nzaw use ``filter-select`` to filter and select items.\n\nyou can use these key binds::\n\n  enter:              accept-line (execute default action)\n  meta + enter:       accept-search (execute alternative action)\n  Tab:                select-action\n  ^G:                 send-break\n  ^H, backspace:      backward-delete-char\n  ^F, right key:      forward-char\n  ^B, left key:       backward-char\n  ^A:                 beginning-of-line\n  ^E:                 end-of-line\n  ^W:                 backward-kill-word\n  ^K:                 kill-line\n  ^U:                 kill-whole-line\n  ^N, down key:       down-line-or-history (select next item)\n  ^P, up key:         up-line-or-history (select previous item)\n  ^V, page up key:    forward-word (page down)\n  ^[V, page down key: backward-word (page up)\n  ^[\u003c, home key:      beginning-of-history (select first item)\n  ^[\u003e, end key:       end-of-history (select last item)\n\nand these zstyles to customize styles::\n\n  ':filter-select:highlight' selected\n  ':filter-select:highlight' matched\n  ':filter-select:highlight' marked\n  ':filter-select:highlight' title\n  ':filter-select:highlight' error\n  ':filter-select' max-lines\n  ':filter-select' rotate-list\n  ':filter-select' case-insensitive\n  ':filter-select' extended-search\n  ':filter-select' hist-find-no-dups\n  ':filter-select' escape-descriptions\n  ':zaw:\u003csource-name\u003e' default \u003cfunc_name\u003e\n  ':zaw:\u003csource-name\u003e' alt \u003cfunc_name\u003e\n\n  example:\n    zstyle ':filter-select:highlight' matched fg=yellow,standout\n    zstyle ':filter-select' max-lines 10 # use 10 lines for filter-select\n    zstyle ':filter-select' max-lines -10 # use $LINES - 10 for filter-select\n    zstyle ':filter-select' rotate-list yes # enable rotation for filter-select\n    zstyle ':filter-select' case-insensitive yes # enable case-insensitive search\n    zstyle ':filter-select' extended-search yes # see below\n    zstyle ':filter-select' hist-find-no-dups yes # ignore duplicates in history source\n    zstyle ':filter-select' escape-descriptions no # display literal newlines, not \\n, etc\n    zstyle ':zaw:git-files' default zaw-callback-append-to-buffer # set default action for git-files\n    zstyle ':zaw:git-files' alt zaw-callback-edit-file # set the alt action for git-files\n\n  extended-search:\n      If this style set to be true value, the searching bahavior will be\n      extended as follows:\n  \n      ^ Match the beginning of the line if the word begins with ^\n      $ Match the end of the line if the word ends with $\n      ! Match anything except the word following it if the word begins with !\n      so-called smartcase searching\n  \n      If you want to search these metacharacters, please doubly escape them.\n\nenvironment variable\n====================\n\nZAW_EDITOR              editor command. If this variable is not set, use EDITOR value.\nZAW_EDITOR_JUMP_PARAM   open editor command with line params.\n                        %LINE% is replaced by line number.\n                        %FILE% is replaced by file path.\n                        default +%LINE% %FILE%\n\n\nmaking sources\n==============\n\nIf you want to make another source, please do!  Look at https://github.com/termoshtt/zaw-systemd\nas an example of how to make a source repo.  Note that it uses the \u003cname\u003e.plugin.zsh\nconvention that plugin managers like zgen and antigen expect for its main file.\nThe sources directory contains the files for the actual sources.  All the sources\nin this repository's ``sources`` directory are good references as well for what\nthe source files should look like.  They tend to be quite simple.\nIf your source requires any additional configuration or dependencies, be sure to\nlist all of that in your project's README file.\n\nLet us know when you make new plugins so we can add them to our list!\n\nlicense\n=======\n\nBSD-3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzsh-users%2Fzaw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzsh-users%2Fzaw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzsh-users%2Fzaw/lists"}