{"id":16547532,"url":"https://github.com/waiting-for-dev/vim-www","last_synced_at":"2025-07-22T23:32:27.787Z","repository":{"id":23194831,"uuid":"26551296","full_name":"waiting-for-dev/vim-www","owner":"waiting-for-dev","description":"Toolbox to open \u0026 search URLs from vim","archived":false,"fork":false,"pushed_at":"2022-08-20T06:03:46.000Z","size":75,"stargazers_count":36,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-03T19:51:04.958Z","etag":null,"topics":["api-documentation","browser","search-engine","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waiting-for-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"waiting-for-dev"}},"created_at":"2014-11-12T19:00:10.000Z","updated_at":"2025-01-23T09:40:26.000Z","dependencies_parsed_at":"2022-07-27T03:47:23.559Z","dependency_job_id":null,"html_url":"https://github.com/waiting-for-dev/vim-www","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/waiting-for-dev/vim-www","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waiting-for-dev%2Fvim-www","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waiting-for-dev%2Fvim-www/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waiting-for-dev%2Fvim-www/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waiting-for-dev%2Fvim-www/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waiting-for-dev","download_url":"https://codeload.github.com/waiting-for-dev/vim-www/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waiting-for-dev%2Fvim-www/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266590083,"owners_count":23952865,"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-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["api-documentation","browser","search-engine","vim"],"created_at":"2024-10-11T19:14:38.578Z","updated_at":"2025-07-22T23:32:27.740Z","avatar_url":"https://github.com/waiting-for-dev.png","language":"Vim script","funding_links":["https://github.com/sponsors/waiting-for-dev"],"categories":[],"sub_categories":[],"readme":"# vim-www\n\nToolbox to open \u0026 search URLs from vim\n\n## Installation\n\nJust like any other vim plugin. Use [pathogen](https://github.com/tpope/vim-pathogen), [neobundle](https://github.com/Shougo/neobundle.vim) or [vundle](https://github.com/gmarik/Vundle.vim), or just [unzip](https://github.com/waiting-for-dev/vim-www/archive/master.zip) it inside your `$HOME/.vim` directory.\n\n## Usage\n\nvim-www allows launching a web browser from vim to open arbitrary URLs, defined favorites and search engine results.\n\nThe web browser to be used is detected automatically, but it can be manually set\nthrough `g:www_launch_browser_command`, optionally using `{{URL}}}` as placeholder for the actual URL. E.g.:\n\n    let g:www_launch_browser_command = \"iceweasel {{URL}} \u0026\"\n\nIn the same way, an alternative CLI browser can be set through `g:www_launch_cli_browser_command`. In order to work, [vim-dispatch](https://github.com/tpope/vim-dispatch) add-on must be installed. Its purpose is to open a web, for example, in a [tmux](https://tmux.github.io/) pane, or in a virtual terminal if [neovim](https://github.com/neovim/neovim) and [vim-dispatch-neovim](https://github.com/radenling/vim-dispatch-neovim) are being used.\n\n### Favorites and arbitrary URLs\n\n`:Wopen` opens any given URL. E.g.:\n\n    :Wopen http://vim.org\n\nBut typing and remembering full URLs is annoying, so custom favorites can be defined in `g:www_urls` dictionary.\n\nSo, having in `vimrc`,\n\n    let g:www_urls = {\n      \\ 'vim' : 'http://www.vim.org',\n      \\ }\n\nfollowing command does the same than previous one:\n\n    :Wopen vim\n\nAlso, in normal mode, `\u003cleader\u003ewo` launches the browser using `WORD` under cursor as URL. In visual mode it does the same but taking current text selection as URL.\n\n`:Wcopen` command and `\u003cleader\u003ewco` mappings do the same but using the CLI browser.\n\n### Search engines\n\n`:Wsearch` queries a search engine and opens the corresponding results page:\n\nE.g.:\n\n    :Wsearch google how to learn vim\n\nPrevious command opens the resulting page of searching `how to learn vim` in google.\n\nFollowing search engines are provided by default:\n\n* bitbucket\n* devdocs\n* duckduckgo\n* google\n* github\n* stackoverflow \n* wikipedia\n\nMore search engines can be added through `g:www_engines` dictionary. Query is appended at the end of given URL.  E.g.:\n\n    let g:www_engines = {\n      \\ 'youtube' : 'https://www.youtube.com/results?search_query=',\n      \\ }\n\nIn normal mode, `\u003cleader\u003ews` searches `WORD` under cursor, while the same mapping in visual mode searches current visual selection. In both cases, the user is prompted to choose which search engine should be used. If none is given, duckduckgo is used, but this behaviour can be changed setting `g:www_default_search_engine` variable. E.g.:\n\n    let g:www_default_search_engine = 'google'\n\n`:Wcsearch` command and `\u003cleader\u003ewcs` mappings do the same but using the CLI browser.\n\n### Shortcut search engines\n\nConvenient shortcuts for commonly used search engines can be defined in `g:www_shortcut_engines` dictionary. Having in `vimrc`:\n\n    let g:www_engines = {\n      \\ 'ruby' : 'http://ruby-doc.com/search.html?q=',\n    \\}\n\n    let g:www_shortcut_engines = {\n      \\ 'ruby': ['Docruby', '\u003cleader\u003edr', 'Doccliruby', '\u003cleader\u003edcr']\n    \\}\n\nautomatically adds `:Docruby` / `:Doccliruby` commands, and `\u003cleader\u003edr` / `\u003cleader\u003edcr` mappings that work like `:Wsearch` / `:Wcsearch` and `\u003cleader\u003ews` / `\u003cleader\u003ewcs` but using ruby straight away as search engine.\n\nRemember that user defined commands must begin with an uppercase letter.\n\nThis is very convenient to use as a quick way to consult API documentation.\n\n### Sessions\n\nArbitrary URLs and favorites can be grouped together under a name in `g:www_sessions` dictionary and opened at once using `:Wsession` command.\n\nHaving in `vimrc`:\n\n    let g:www_urls = {\n      \\ 'vim' : 'http://www.vim.org',\n      \\ }\n\n    let g:www_sessions = {\n      \\ 'dev' : ['vim', 'http://stackoverflow.com'],\n      \\ }\n\nRunning:\n\n    :Wsession vim\n\nwould open `http://www.vim.org` and `http://stackoverflow.com` at once.\n\n`:Wcsession` command does the same but using the CLI browser.\n\n## Configuration and reference\n\nType `:help vim-www` for a complete reference and information about configuration.\n\n## Bugs\n\nOpen a bug in https://github.com/waiting-for-dev/vim-www/issues\n\n## Contributing\n\n1. Fork the project ( http://github.com/waiting-for-dev/vim-www/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n\n## Version\n\nvim-www follows [Semantic Versioning System 2.0](http://semver.org/). Current\nversion is 1.1.0.\n\n## License\n\nThe MIT Licence\nhttp://www.opensource.org/licenses/mit-license.php\n\nCopyright (c) 2014 Marc Busqué Pérez\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaiting-for-dev%2Fvim-www","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaiting-for-dev%2Fvim-www","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaiting-for-dev%2Fvim-www/lists"}