{"id":13898586,"url":"https://github.com/mhinz/vim-halo","last_synced_at":"2025-04-12T14:11:07.496Z","repository":{"id":145654681,"uuid":"72301283","full_name":"mhinz/vim-halo","owner":"mhinz","description":":innocent: Visual highlight for your cursor.","archived":false,"fork":false,"pushed_at":"2021-04-04T14:38:55.000Z","size":585,"stargazers_count":50,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-26T08:47:38.290Z","etag":null,"topics":["async","blink","cursor","halo","highlight","neovim","vim","vim-plugin"],"latest_commit_sha":null,"homepage":"","language":"Vim script","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/mhinz.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}},"created_at":"2016-10-29T18:07:20.000Z","updated_at":"2025-01-14T12:23:16.000Z","dependencies_parsed_at":"2024-02-23T12:00:17.891Z","dependency_job_id":null,"html_url":"https://github.com/mhinz/vim-halo","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/mhinz%2Fvim-halo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhinz%2Fvim-halo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhinz%2Fvim-halo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhinz%2Fvim-halo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mhinz","download_url":"https://codeload.github.com/mhinz/vim-halo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248578874,"owners_count":21127713,"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":["async","blink","cursor","halo","highlight","neovim","vim","vim-plugin"],"created_at":"2024-08-06T18:04:21.763Z","updated_at":"2025-04-12T14:11:07.474Z","avatar_url":"https://github.com/mhinz.png","language":"Vim script","funding_links":[],"categories":["Vim Script"],"sub_categories":[],"readme":"# vim-halo\n\nHighlight the cursor by putting blinking shapes around it.\n\nBy default, the shape is a halo and the cursor blinks three times. This can be\nused to quickly find the cursor after switching buffers etc. Moving the cursor\nwill stop the blinking immediately.\n\n![vim-halo in action](https://raw.githubusercontent.com/mhinz/vim-halo/master/demo.gif)\n\n## Usage\n\nThere is only one function `halo#run()`, which takes one optional argument, a\ndictionary.\n\nThe dictionary takes up to 3 keys:\n\n- **hlgroup**: Highlight group as *string*. Default is `Halo` which links to\n  `IncSearch`.\n- **shape**: Shape as a *string*. Can by any of `halo1`, `halo2`, `cross1`,\n  `cross2`, `cross2halo1`, `rectangle2`, or `line`. Default is `halo1`.\n- **intervals**: A *list of numbers*. Calling `halo#run()` immediately shows a\n  visual highlight. The numbers denote the alternating times visual highlights\n  are shown and hidden. Thus an odd number of elements is sensible. Given an\n  even number, the last element is ignored. Default is `[100,100,100,100,100]`.\n\n```\n:call halo#run()\n:call halo#run({'shape': 'cross2halo1'})\n:call halo#run({'intervals': [100, 300, 600, 300, 100]})\n:call halo#run({'intervals': [200,200,200], 'hlgroup': 'IncSearch'})\n```\n\n## Examples\n\nEvery time you change buffers:\n\n```vim\nautocmd BufEnter * call halo#run()\n```\n\nWhen navigating the quickfix or location list:\n\n```vim\nnnoremap [q  :cprevious \\| call halo#run()\u003ccr\u003e\nnnoremap ]q  :cnext \\| call halo#run()\u003ccr\u003e\nnnoremap [Q  :cfirst \\| call halo#run()\u003ccr\u003e\nnnoremap ]Q  :clast \\| call halo#run()\u003ccr\u003e\n\nnnoremap [l  :lprevious \\| call halo#run()\u003ccr\u003e\nnnoremap ]l  :lnext \\| call halo#run()\u003ccr\u003e\nnnoremap [L  :lfirst \\| call halo#run()\u003ccr\u003e\nnnoremap ]L  :llast \\| call halo#run()\u003ccr\u003e\n```\n\nUse colors from another highlight group:\n\n```vim\nhighlight link Halo Search\n```\n\nOr define your own colors:\n\n```vim\nhighlight Halo guifg=white guibg=#F92672 ctermfg=white ctermbg=197\n```\n\n## Disclaimer\n\nOnly the `line` shape works works with wrapped lines!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhinz%2Fvim-halo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmhinz%2Fvim-halo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhinz%2Fvim-halo/lists"}