{"id":13479869,"url":"https://github.com/wakatime/vim-wakatime","last_synced_at":"2025-05-16T07:03:58.674Z","repository":{"id":9140769,"uuid":"10932026","full_name":"wakatime/vim-wakatime","owner":"wakatime","description":"Vim plugin for automatic time tracking and metrics generated from your programming activity.","archived":false,"fork":false,"pushed_at":"2025-05-03T14:22:38.000Z","size":6390,"stargazers_count":1082,"open_issues_count":5,"forks_count":70,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-05-03T15:28:35.169Z","etag":null,"topics":["neovim-plugin","time-tracking","vim","vim-plugins","vundle"],"latest_commit_sha":null,"homepage":"https://wakatime.com/vim","language":"Vim Script","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/wakatime.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.rst","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-06-25T07:55:27.000Z","updated_at":"2025-05-03T14:22:42.000Z","dependencies_parsed_at":"2023-10-12T21:46:45.845Z","dependency_job_id":"ad4384b6-a76e-4cdc-8c04-3222df4b7f33","html_url":"https://github.com/wakatime/vim-wakatime","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wakatime%2Fvim-wakatime","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wakatime%2Fvim-wakatime/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wakatime%2Fvim-wakatime/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wakatime%2Fvim-wakatime/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wakatime","download_url":"https://codeload.github.com/wakatime/vim-wakatime/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254485053,"owners_count":22078767,"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":["neovim-plugin","time-tracking","vim","vim-plugins","vundle"],"created_at":"2024-07-31T16:02:24.359Z","updated_at":"2025-05-16T07:03:58.652Z","avatar_url":"https://github.com/wakatime.png","language":"Vim Script","funding_links":[],"categories":["Vim Script","Lua"],"sub_categories":[],"readme":"# vim-wakatime\n\n[![Vim](https://wakatime.com/static/img/Vim-supported-brightgreen.svg)](https://github.com/wakatime/vim-wakatime#installation)\n[![Neovim](https://wakatime.com/static/img/Neovim-supported-brightgreen.svg)](https://github.com/wakatime/vim-wakatime#installation)\n[![MacVim](https://wakatime.com/static/img/MacVim-supported-brightgreen.svg)](https://github.com/wakatime/vim-wakatime#installation)\n[![gVim](https://wakatime.com/static/img/gVim-supported-brightgreen.svg)](https://github.com/wakatime/vim-wakatime#installation)\n[![Coding time tracker](https://wakatime.com/badge/github/wakatime/vim-wakatime.svg)](https://wakatime.com/badge/github/wakatime/vim-wakatime)\n\n[WakaTime][wakatime] is an open source Vim plugin for metrics, insights, and time tracking automatically generated from your programming activity.\n\n## Installation\n\n1. With [Vundle](https://github.com/gmarik/vundle): `echo \"Plugin 'wakatime/vim-wakatime'\" \u003e\u003e ~/.vimrc \u0026\u0026 vim +PluginInstall`\n\n   Or with [Pathogen](https://github.com/tpope/vim-pathogen): `cd ~/.vim/bundle \u0026\u0026 git clone https://github.com/wakatime/vim-wakatime.git`\n\n   Or with [Vim-plug](https://github.com/junegunn/vim-plug):  add `Plug 'wakatime/vim-wakatime'` to .vimrc file. While in vim reload .vimrc with `:so ~/.vimrc` or restart vim, enter\n    `:PlugInstall`\n\n   Or with [Packer](https://github.com/wbthomason/packer.nvim): add `use 'wakatime/vim-wakatime'` to your plugins file.\n\n   Or with [Vim 8+](https://www.vim.org/): `mkdir -p ~/.vim/pack/plugins/start \u0026\u0026 cd ~/.vim/pack/plugins/start \u0026\u0026 git clone https://github.com/wakatime/vim-wakatime.git`\n\n   Or with [Lazy.nvim](https://github.com/folke/lazy.nvim.git): add to your plugins file.\n   ```lua\n   { 'wakatime/vim-wakatime', lazy = false }\n   ```\n\n3. Restart Vim.\n\n4. If this is the first WakaTime plugin on your machine, type `:WakaTimeApiKey` inside Vim.\n\n5. Enter your [API Key](https://wakatime.com/api-key), then press `enter`.\n\n6. Use Vim and your coding activity will be displayed on your [WakaTime dashboard](https://wakatime.com).\n\n\n## Screen Shots\n\n![Project Overview](https://wakatime.com/static/img/ScreenShots/Screen-Shot-2016-03-21.png)\n\n\n## Commands\n\n* `:WakaTimeApiKey` - set or change the api key saved in your `~/.wakatime.cfg`\n* `:WakaTimeDebugEnable` - enable debug mode (may slow down Vim so disable when finished debugging)\n* `:WakaTimeDebugDisable` - disable debug mode\n* `:WakaTimeScreenRedrawEnable` - enable screen redraw to prevent artifacts (only for Vim \u003c 8.0)\n* `:WakaTimeScreenRedrawEnableAuto` - redraw screen when plugin takes too long (only for Vim \u003c 8.0)\n* `:WakaTimeScreenRedrawDisable` - disable screen redraw\n* `:WakaTimeToday` - echo your total coding activity for Today\n\nThe vim-wakatime plugin automatically downloads and updates [wakatime-cli][wakatime-cli] in your `$WAKATIME_HOME/.wakatime/` folder.\nWakaTime plugins also share a common [$WAKATIME_HOME/.wakatime.cfg config file][wakatime-cli-config].\n`$WAKATIME_HOME` defaults to your `$HOME` folder.\n\n\n## Troubleshooting\n\nRun `:WakaTimeDebugEnable` in Vim then run this Terminal command:\n\n`tail -f ~/.wakatime/wakatime.log`\n\nEnabling Debug Mode writes Vim Script errors to your Vim Status Bar and tells [wakatime-cli][wakatime-cli] to write verbose logs to `$WAKATIME_HOME/.wakatime/wakatime.log`.\n\nDebug mode can make it hard to find the real error because of all the extra logging, so also try disabling Debug Mode while tailing `~/.wakatime/wakatime.log` and editing files in Vim.\nWith Debug Mode enabled, the plugin sends data synchronously so disable it when finished debugging with `:WakaTimeDebugDisable`.\n\nThe [How to Debug Plugins][how to debug] guide shows how to check when coding activity was last received from Vim use the [User Agents API][user agents api].\nFor more general troubleshooting info, see the [wakatime-cli Troubleshooting Section][wakatime-cli-help].\n\n\n## Uninstalling\n\n1. Remove `Plugin 'wakatime/vim-wakatime'` from your `.vimrc` file.\n\n2. Run in terminal: `rm ~/.wakatime.*`.\n\n3. Run in terminal: `vim +PluginClean`.\n\n**_If using vim-plug_**\n\n_While in vim_\n\n1. Delete or comment out `Plug` command from .vimrc file.\n\n2. Reload vimrc (`:so ~/.vimrc`) or restart vim\n\n3. Run `:PlugClean`, it will detect and remove undeclared plugins.\n\n[wakatime]: https://wakatime.com/vim\n[wakatime-cli]: https://github.com/wakatime/wakatime-cli\n[wakatime-cli-config]: https://github.com/wakatime/wakatime-cli/blob/develop/USAGE.md#ini-config-file\n[wakatime-cli-help]: https://github.com/wakatime/wakatime#troubleshooting\n[how to debug]: https://wakatime.com/faq#debug-plugins\n[user agents api]: https://wakatime.com/developers#user_agents\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwakatime%2Fvim-wakatime","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwakatime%2Fvim-wakatime","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwakatime%2Fvim-wakatime/lists"}