Obsidian Stats logoObsidian Stats

GitLine

by qingchuan
5
4
3
2
1
Score: 50/100
Install Code

Description

Reviews

No reviews yet.

Stats

0
stars
10
downloads
0
forks
4
days
4
days
4
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
9
commits

Latest Version

0.1.2
5 days ago

Changelog

GitLine 0.1.2

What's new

  • Review compliance: settings heading no longer repeats the plugin name
  • Replace builtin-modules dependency with Node built-in node:module (build hygiene)
  • Use Obsidian's Setting.setHeading() and createEl helpers (review compliance)

Features

  • Show Git blame (time / author / message) at the end of the current line
  • Configurable display format
  • Works with any vault inside a Git repository

Files

  • main.js, manifest.json, styles.css attached as release assets (required by Obsidian)
See all version on GitHub

README file from

Github

GitLine

GitLine is an Obsidian desktop plugin that shows Git blame information at the end of the current cursor line. Each line displays the committer, the commit time, and the commit message, using a fully configurable format.

preview

简体中文版

Features

  • Line-end blame: the blame information of the current cursor line is rendered as an inline annotation at the end of the line.
  • Configurable format: assemble the display freely with the {date}, {time}, {author}, {message} and {hash} placeholders.
  • Flexible timestamps: choose between relative time (e.g. "3 days ago") and absolute time, accurate to the minute.
  • Uncommitted lines: lines that have not been committed yet are marked as Uncommitted.
  • Status bar: shows the author of the current line (optional).
  • Whitespace handling: git blame -w can be enabled to ignore whitespace-only changes.
  • Caching: an LRU cache avoids repeated git calls; entries are invalidated automatically when a file is saved.
  • Robustness: git is detected automatically; a friendly hint is shown instead of an error when git is unavailable.

Requirements

  • Obsidian desktop (the plugin uses Node.js APIs and is desktop-only).
  • Git installed and available on PATH (git --version must succeed).

Installation

  1. Copy the gitline plugin folder into <your vault>/.obsidian/plugins/gitline/.
  2. In Obsidian, open Settings → Community plugins, and enable GitLine.

Once the plugin is published, it can also be installed directly from the community plugin list.

Usage

Open a note that lives in a Git repository and move the cursor. The blame information appears at the end of the current line.

Settings

Setting Description Default
Enable Master switch for the line-end blame display. On
Display format Template with placeholders{date} {time} {author} {message} {hash}. {author} {time} {message}
Time style Relative (e.g. "3 days ago") or Absolute (accurate to the minute). Absolute
Absolute time format Moment format string. YYYY-MM-DD HH:mm
Uncommitted lines Show a marker on uncommitted lines. On
Ignore whitespace Map togit blame -w. Off
Status bar Show the current line's author in the status bar. On
Cache size Maximum number of files kept in the LRU cache. 100

Development

npm install   # install dependencies
npm run dev   # watch and build main.js
npm run build # type-check and build for production

License

MIT

Sponsors