{"id":28384801,"url":"https://github.com/bignimbus/you-are-here.vim","last_synced_at":"2025-10-09T05:38:11.466Z","repository":{"id":148002482,"uuid":"287682116","full_name":"bignimbus/you-are-here.vim","owner":"bignimbus","description":"📌 See the filenames of your vim splits in easy-to-read popups, switch seamlessly","archived":false,"fork":false,"pushed_at":"2024-02-13T15:09:04.000Z","size":876,"stargazers_count":104,"open_issues_count":3,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-26T00:36:17.665Z","etag":null,"topics":["vim"],"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/bignimbus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-08-15T05:12:39.000Z","updated_at":"2025-05-03T17:49:35.000Z","dependencies_parsed_at":"2023-03-29T03:48:00.349Z","dependency_job_id":null,"html_url":"https://github.com/bignimbus/you-are-here.vim","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bignimbus/you-are-here.vim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bignimbus%2Fyou-are-here.vim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bignimbus%2Fyou-are-here.vim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bignimbus%2Fyou-are-here.vim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bignimbus%2Fyou-are-here.vim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bignimbus","download_url":"https://codeload.github.com/bignimbus/you-are-here.vim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bignimbus%2Fyou-are-here.vim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000739,"owners_count":26082932,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","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":["vim"],"created_at":"2025-05-30T09:39:46.817Z","updated_at":"2025-10-09T05:38:11.461Z","avatar_url":"https://github.com/bignimbus.png","language":"Vim Script","funding_links":[],"categories":[],"sub_categories":[],"readme":"# you-are-here.vim\n📌 See the filenames of your vim splits in easy-to-read popups, switch windows seamlessly\n\n![you-are-here.vim screenshot](https://github.com/bignimbus/you-are-here.vim/blob/main/assets/you-are-here.png)\n\n---\n\nThis is a small plugin to solve a small problem.\nThe problem is that having more than a few splits\nopen can be disorienting for onlookers in pair\nprogramming sessions, demos, or presentations.\nEvery now and then, you may even find yourself\nwanting a quick, readable, at-a-glance overview of\nthe visible splits on the screen.\n\nThe solution is this plugin. A key map activates\na popup centered in each visible split.  Each popup\ncontains the name of the filename of the split that\ncontains it.  Some small conveniences are included\nto facilitate switching windows by their window\nnumber.  For more information on window numbers,\nsee `:help winnr` in the vim docs.\n\n## Installation\n\n```vim\n\" vim-plug example\n\ncall plug#begin('~/.vimplugins')\n\nPlug 'bignimbus/you-are-here.vim'\n\ncall plug#end()\n\n\" Add a map of your choice.  I prefer to  use\n\" \u003cleader\u003ehere.  My leader key is set to the\n\" backslash (\\), so by typing \\here in normal\n\" mode, I activate you-are-here.vim. When I\n\" am ready to close the popups, I use the same\n\" mapping.\n\nnnoremap \u003csilent\u003e \u003cleader\u003ehere :call you_are_here#Toggle()\u003cCR\u003e\n\n\" If you want the popups to disappear automatically\n\" after a while, you may also use ToggleFor(duration):\nnnoremap \u003csilent\u003e \u003cleader\u003ehere :call you_are_here#ToggleFor(2500)\u003cCR\u003e\n\n\" Optional: \n\n\" If you want to add a different (shorter?) map\n\" to close the popups, that option is available.\n\" I personally prefer to use \u003cESC\u003e but that's a bit\n\" intrusive so I don't endorse it :)\nnnoremap \u003csilent\u003e \u003cleader\u003ebye :call you_are_here#Close()\u003cCR\u003e\n\n\" Most users wouldn't need to manually refresh you-are-here\n\" while it's open, but it's possible:\nnnoremap \u003csilent\u003e \u003cleader\u003eupd :call you_are_here#Update()\u003cCR\u003e\n```\n\n## Usage\n\nActivate `you-are-here.vim` by using the keybinding above\n(the recommended binding is `\u003cleader\u003ehere`).  While the\npopups are active, use `m1` to switch to window `1`, `m2`\nto switch to window `2`, and so on.  These mappings are\nconfigurable and users can opt-out from these small\nconveniences if they prefer plugins that don't map keys.\n\n`\u003cleader\u003ehere` will close the popups and unmap the\naforementioned mappings, as will the optional mapping to\n`you_are_here#Close()`.\n\n## Config\n\n|Variable|Default|Notes|\n|---|---|---|\n|`g:youarehere_switch_window_mapping_prefix`|`\"m\"`|While the popups are open, `you-are-here.vim` adds a keymapping to switch windows easily. `m1` focuses window `1`, `m2` focuses window `2`, and so on.  If you wish for a different prefix, such as `\u003cleader\u003ew`, pass it as a string literal `\"\u003cleader\u003ew\"`|\n|`g:youarehere_enable_switch_window_mappings`|`1`|Turn off the map described above by assigning `0` to this variable|\n|`g:youarehere_content`|`\"%\"`|The argument passed to `expand()`.  Don't touch this without referring to `:help expand`|\n|`g:youarehere_padding`|`[1, 1, 1, 1]`|How many characters of padding on the top, right, bottom, and left of the popup windows|\n|`g:youarehere_border`|`[1, 1, 1, 1]`|How thick the border is at the top, right, bottom, and left of the popup windows|\n|`YouAreHereText`|`Pmenu`|Highlight group for inactive popup content|\n|`YouAreHereBorder`|`Pmenu`|Highlight group for inactive popup borders|\n|`YouAreHereScrollbar`|`PmenuSbar`|Highlight group for inactive popup scrollbars|\n|`YouAreHereThumb`|`PmenuThumb`|Highlight group for inactive popup scrollbar thumb|\n|`YouAreHereActiveText`|`Pmenu`|Highlight group for active popup content|\n|`YouAreHereActiveBorder`|`PmenuSel`|Highlight group for active popup borders|\n|`YouAreHereActiveScrollbar`|`PmenuSbar`|Highlight group for active popup scrollbars|\n|`YouAreHereActiveThumb`|`PmenuThumb`|Highlight group for active popup scrollbar thumb|\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbignimbus%2Fyou-are-here.vim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbignimbus%2Fyou-are-here.vim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbignimbus%2Fyou-are-here.vim/lists"}