{"id":14978938,"url":"https://github.com/genotrance/vire","last_synced_at":"2025-10-28T14:30:41.169Z","repository":{"id":47631865,"uuid":"133712484","full_name":"genotrance/vire","owner":"genotrance","description":"Vim / Neovim installer and vimrc + plugin manager","archived":false,"fork":false,"pushed_at":"2021-08-20T15:23:14.000Z","size":18,"stargazers_count":18,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-01T15:11:31.504Z","etag":null,"topics":["installer","manager","neovim","plugin","plugin-manager","plugins","vim","vimrc"],"latest_commit_sha":null,"homepage":"","language":"Python","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/genotrance.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.txt","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-16T19:14:47.000Z","updated_at":"2024-12-03T06:33:31.000Z","dependencies_parsed_at":"2022-08-05T04:30:16.397Z","dependency_job_id":null,"html_url":"https://github.com/genotrance/vire","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genotrance%2Fvire","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genotrance%2Fvire/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genotrance%2Fvire/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genotrance%2Fvire/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/genotrance","download_url":"https://codeload.github.com/genotrance/vire/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238662632,"owners_count":19509638,"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":["installer","manager","neovim","plugin","plugin-manager","plugins","vim","vimrc"],"created_at":"2024-09-24T13:58:40.267Z","updated_at":"2025-10-28T14:30:35.884Z","avatar_url":"https://github.com/genotrance.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vire\n\n## What is Vire?\nVire is a simple Vim / Neovim installer and vimrc + plugin or package manager.\n\nVire makes it simple to install and keep Vim or Neovim up to date on Windows.\n\nInstall Vim:\n\n  `vire -i`\n\nInstall Neovim:\n\n  `vire -i -n`\n\nThis will download and install the binary from Github and extract to the HOME\ndirectory. The directory will also be added to the user path so that starting\n`[g]vim.exe` or `nvim[-qt].exe` is easy. It will install either the 32-bit or\n64-bit version depending on the architecture of Python since a mismatch will\nprevent Python plugins from working.\n\nInstallation on Linux is left to the distro package managers.\n\nVire also makes it super easy to install your `vimrc`. The recommended method is\nto maintain the `vimrc` as a gist on Github. [Here's](https://gist.github.com/genotrance/57d327501443f440f522e2c886dadc1b) my vimrc for example.\nAll Vire needs is the gist ID and it is able to keep the local copy up to date.\nAll updates can be made on Github and simply running Vire on each machine will\nget everything up to date. This strategy makes it simple to keep multiple\nmachines in sync.\n\n  `vire gistID`\n\nLastly, Vire does what every other plugin manager does - install every plugin\ndefined in the vimrc loaded. One advantage of using Vire is that it does not\ndepend on Git to download plugins and leverages Vim / Neovim's built-in `pack`\nmethod of loading plugins.\n\nVire only requires Python which is what most modern Vim / Neovim plugins require\nand made the most sense to build upon.\n\n## Installation\n\nFirst download and install a Python distribution if not already present.\n\nVire can be installed in multiple ways, easiest being from PyPI:\n\n  `pip install vire`\n\nOr as a regular user:\n\n  `pip install vire --user`\n\nIf `pip` isn't available or preferred, one of the following methods can be used\nto download:\n\n- Clone the latest source:\n\n  `git clone https://github.com/genotrance/vire`\n\n- Download the latest source ZIP:\n\n  `https://github.com/genotrance/vire/archive/master.zip`\n\nVire along with all dependencies can then be installed to the standard Python\nlocation using:\n\n  `python setup.py install`\n\nOr as a regular user:\n\n  `python setup.py install --user`\n\nInstalling Vire as a regular user will require adding `%APPDATA%\\Roaming\\Python\\PythonVER\\Scripts`\nor `~/.local/bin` to the path.\n\nVire can also be used without installation with `python vire.py` but will require\nall dependencies to be installed manually.\n\n  `pip install pygithub requests` for Python 3.x\n\n  `pip install pygithub requests futures pathlib2` for Python 2.x\n\nAfter installation, Vire can be run on the command line like an executable.\n\n  `vire -h`\n\n## Typical Scenario\n\n- Download and install Vire\n\n- Install Vim / Neovim if required\n\n  `vire -i [-n]`\n\n- Post vimrc to Github gist if not already\n\n- Backup and remove any existing configuration files and directories so that\n  Virc can setup from scratch. NOTE: Vire will not overwrite any existing\n  configuration if detected unless told to with `-f`. If forced, the existing\n  `vimrc` will be overwritten and the `pack/vire/start` directory will get\n  cleaned and repopulated with plugins as specified in the `vimrc` provided. Any\n  other directories and files will remain in place and might conflict so it is\n  preferred to start with a clean slate.\n\n- If you want to use Vire for all plugins:\n  - Edit vimrc to remove all function calls related to plugin managers like Pathogen,\n    Vundle, vim-plug, etc.\n  - Comment out all lines pointing to plugins. This will be used by Vire to download\n    and install instead. For example, for Vundle:\n\n    `Plugin 'tpope/vim-fugitive'` =\u003e `\" Plugin 'tpope/vim-fugitive'`\n\n  - Or for vim-plug:\n\n    `Plug 'tpope/vim-fugitive'` =\u003e `\" Plug 'tpope/vim-fugitive'`\n\n  - For other plugins, you  will need to add such `\" Plug 'user/project'` manually\n    for each plugin that needs to be installed.\n\n- If you prefer to use your existing plugin manager to download your plugins,\n  you can use Vire to only install the plugin manager and leave the rest of the\n  vimrc as is:\n\n  `\" Plug 'VundleVim/Vundle.vim'`\n  `\" Plug 'junegunn/vim-plug'`\n  `\" Plug 'Shougo/dein.vim'`\n\n- Run Vire to download and install the vimrc and plugins:\n\n  `vire gistID`\n\n- When you need to update, simply run `vire` and it will check if anything has\n  changed. Running with `-i` will also check if the app itself has an update.\n\n## Configuration\n\nVire maintains a `~/.vire.json` to remember things such as the gist ID, 32-bit\nmode, Vim or Neovim mode and other details to detect when an update is available.\n\nNo manual editing should be required, the command line parameters should be all\nthat's required.\n\n## Usage\n\n```\nusage: vire [-h] [-b] [-f] [-i] [-n] [-v] [vimrc]\n\npositional arguments:\n  vimrc          Gist ID or path to vimrc file\n\noptional arguments:\n  -h, --help     show this help message and exit\n  -b, --bit32    Force 32-bit install\n  -f, --force    Force Vim reinstall\n  -i, --install  Install Vim/Neovim\n  -n, --neomode  Neovim mode\n  -v, --vimmode  Vim mode [default]\n```\n\n## Dependencies\n\nVire only requires Python and the PyGithub module at this time. Setuptools is\nalso required if using `setup.py`.\n\nVire is tested on Windows with Python 3.6 using the Miniconda distribution and\non Ubuntu Artful with Python 2.7 and 3.6.\n\n## Feedback\n\nVire is definitely a work in progress and any feedback or suggestions are welcome.\nIt is hosted on [GitHub](https://github.com/genotrance/vire) with an MIT license\nso issues, forks and PRs are most appreciated.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenotrance%2Fvire","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgenotrance%2Fvire","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenotrance%2Fvire/lists"}