{"id":13896388,"url":"https://github.com/ttys3/nvim-blamer.lua","last_synced_at":"2025-07-17T12:33:23.166Z","repository":{"id":101550617,"uuid":"322287863","full_name":"ttys3/nvim-blamer.lua","owner":"ttys3","description":"use https://github.com/lewis6991/gitsigns.nvim instead","archived":true,"fork":false,"pushed_at":"2021-07-03T18:25:45.000Z","size":189,"stargazers_count":35,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-25T02:31:56.026Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Lua","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/ttys3.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2020-12-17T12:26:57.000Z","updated_at":"2024-07-01T06:10:33.000Z","dependencies_parsed_at":"2023-06-05T10:30:36.140Z","dependency_job_id":null,"html_url":"https://github.com/ttys3/nvim-blamer.lua","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/ttys3/nvim-blamer.lua","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2Fnvim-blamer.lua","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2Fnvim-blamer.lua/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2Fnvim-blamer.lua/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2Fnvim-blamer.lua/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ttys3","download_url":"https://codeload.github.com/ttys3/nvim-blamer.lua/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2Fnvim-blamer.lua/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265606777,"owners_count":23797004,"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":[],"created_at":"2024-08-06T18:02:52.915Z","updated_at":"2025-07-17T12:33:22.836Z","avatar_url":"https://github.com/ttys3.png","language":"Lua","funding_links":[],"categories":["Lua"],"sub_categories":[],"readme":"# A git blame plugin for neovim inspired by VS Code's GitLens plugin\n\n![nvim-blamer-lua](nvim-blamer-lua.png)\n\n## requirement\n\nneovim version: \u003e= 0.5.0-dev ( or nightly version )\n\nthe `git` cli must exists in your system and in `PATH` env\n\n## features\n\n- configuable message format\n- delay auto hide feature\n- dynamic toggle\n\n\n## usage\n\njust install the plugin and it should works automatically.\n\nfor example, use [vim-plug](https://github.com/junegunn/vim-plug)\n\n```vim\nPlug 'ttys3/nvim-blamer.lua'\n\n\"\"\" must after plugin loaded, for example,\n\"\"\" if you are using vim-plug, this should put after `call plug#end()`\n\"\"\" enable auto show blame info when cursor move\ncall nvimblamer#auto()\n\n\"\"\" config the plugin\nlua \u003c\u003cEOF\n\nrequire'nvim-blamer'.setup({\n    enable = true,\n    format = '%committer │ %committer-time-human │ %summary',\n})\n\nEOF\n\n```\n\n## default config\n\n```lua\n{\n    enable = false,  -- you must set this to true in order to show the blame info\n    prefix = '  ', -- you can cusomize it to any thing, unicode emoji, even disable it, just set to empty lua string\n    format = '%committer │ %committer-time %committer-tz │ %summary',\n    auto_hide = false, -- set this to true will enable delay hide even you do not have the cursor moved\n    hide_delay = 3000, -- this is the delay time in milliseconds for delay auto hide\n    show_error = false, -- set to true to show any possible error (just for debug problems)\n}\n```\n\nyou may need install some patched font to use unicode emoji, like NerdFont \u003chttps://github.com/ryanoasis/nerd-fonts\u003e\n\nyou can find your favorite emoji using \u003chttps://www.nerdfonts.com/cheat-sheet\u003e\n\nhere are some emoji candicates:\n\n`\\uE702` \n\n`\\uF1D2` \n\n`\\uF1D3` \n\n`\\uE80D` \n\n`\\uF417` \n\n## availabe template vars\n\nyou can use `filename`, `hash`, `summary`, `committer`, `committer-mail`, `committer-tz`, `committer-time` and `committer-time-human`\n\n```json\n{\n  \"filename\": \"lua/blamer.lua\",\n  \"hash\": \"db43ae622dbec1ba3fd8172c2d4fed1b2980c39c\",\n  \"hash-short\": \"db43ae6\",\n  \"summary\": \"fix: bypass ft list: rename LuaTree to NvimTree. do not show Not Committed Yet msg\",\n\n  \"committer\": \"荒野無燈\",\n  \"committer-mail\": \"\u003ca@example.com\u003e\",\n  \"committer-tz\": \"+0800\",\n  \"committer-time\": \"1610563580\",\n\n  \"author\": \"荒野無燈\",\n  \"author-mail\": \"\u003ca@example.com\u003e\",\n  \"author-time\": \"1610563580\",\n  \"author-tz\": \"+0800\",\n}\n```\n\n## available commands\n\n```vim\n\"\"\" auto show blame info when cursor move\n:NvimBlamerAuto\n\n\"\"\" toggle blame info display\n:NvimBlamerToggle\n```\n\n## credits\n\nthanks for the unicode emoji from \u003chttps://github.com/romkatv/powerlevel10k/blob/3920940ea84f6fba767cbed3fe6ba0653411c706/internal/icons.zsh#L226\u003e\n\nthe idea and the init code come from https://www.reddit.com/r/neovim/comments/f1vxhl/replicate_the_basic_functionality_vscodes_gitlens/\nhttps://teukka.tech/vimtip-gitlens.html\n\n\n## related works\n\n\u003chttps://github.com/APZelos/blamer.nvim\u003e\n\n\u003chttps://github.com/f-person/git-blame.nvim\u003e\n\n\u003chttps://github.com/tveskag/nvim-blame-line\u003e\n\n\u003chttps://github.com/zivyangll/git-blame.vim\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fttys3%2Fnvim-blamer.lua","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fttys3%2Fnvim-blamer.lua","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fttys3%2Fnvim-blamer.lua/lists"}