Owen Graphite

by towishy
Screenshot of the Owen Graphite Obsidian theme
5
4
3
2
1

Description

This theme supports Dark Mode
This theme supports Light Mode

README file from

Github

Owen Kit

GitHub release License Obsidian !important

Style Settings presets · Compatibility matrix · Changelog

Owen Graphite — Obsidian Theme

Owen Graphite v3.1.99 is a liquid-glass Obsidian theme for technical documentation, knowledge bases, and report-ready notes, giving Korean/English typography, long tables, code blocks, workspace chrome, Style Settings controls, and PDF export layouts one calm graphite surface across Live Preview, Reading View, and print.

Theme-first, optional companion: Owen Graphite keeps its Style Settings schema and English/Korean metadata inside the theme. Owen Graphite Companion 1.3.0 supplies the Style Settings locale fallback and structures Obsidian's title/metadata tooltips for wrapped bold titles. Persistent code-title editing, code copying, and canonical Frosted ScrollArea controls are available through Owen Editor 0.6.34.

Why Owen Graphite?

Workflow What you feel immediately
Long technical notes CJK/Latin paragraphs, headings, code, and dense tables keep a stable rhythm without feeling cramped.
Live Preview writing Editing, Reading View, and rendered widgets share the same quiet surfaces for tables, code blocks, callouts, and embeds.
Report and PDF handoff Header/footer labels, page numbering, paper-size-preserving readability, and page-break guards support recurring report delivery.
Daily workspace navigation Tabs, long-name folder ellipsis, unified metadata tooltips, search, settings, popovers, and type badges use a restrained graphite liquid-glass language.

Design And Function Snapshot

Surface Design signal Function signal
Workspace chrome Frosted white/graphite panels, connected tooltip tails, shallow rims, and soft lift states Active files, long folder names, parent folders, tabs, and vault controls stay scannable in large vaults.
Writing surface Calm document panes with balanced body, code, table, and callout density Long Korean/English technical pages remain readable through editing and review.
Settings and presets Compact glass controls instead of loud colored panels Style Settings exposes PDF, typography, spacing, chrome, and accessibility options without visual clutter.
PDF export Report labels, selected-paper readability presets, and print-safe spacing Notes can become screen-shared PDFs or formal report output without silently changing the selected paper size.

Release Confidence

Guard Current status Evidence
Bundle freshness theme.css must match dist/theme-v3.css release plan
Zero-important cascade declaration-level !important policy is enforced cascade research
Style Settings contract option ids/defaults are audited against the contract contract
Docs/assets links local Markdown links and README images are audited contributing
Live Preview/PDF parity LP hit-routing, PDF header/footer, and visual fixture checks are scripted release plan

Visual Tour

Surface Preview
Light mode Light Mode
Dark mode Dark Mode
Top tabs and floating toolbar Top tabs and floating toolbar
Writing surface and floating toolbar Writing surface and floating toolbar
Style Settings report controls Style Settings report controls
Owen Editor toolbar controls Owen Editor toolbar controls
File explorer type badges File explorer type badges

New comparison screenshots should follow the visual comparison guide so default Obsidian and Owen Graphite are captured with the same note, viewport, and state.


1. Theme Profile

Item Value
Version 3.1.99
Baseline / rollback target v3.1.99
Mode support Light / Dark
Platform Desktop & Mobile
Design policy Liquid Glass core · token-first surfaces · zero-important cascade

Light Mode Dark Mode


2. Latest Highlights

Install the Style Settings plugin to unlock the report, typography, spacing, PDF, and workspace polish controls referenced below.

v3.1.99 — macOS Chrome And Code Alignment

This release clarifies workspace interaction states and keeps macOS scroll and code controls on their intended channels.

Area What changed
Chrome states Workspace, settings, tabs, search, floating UI, and shared liquid-glass surfaces use quieter resting, hover, active, and focus treatments backed by a dedicated fixture.
File explorer macOS no longer shows the native overlay scrollbar beside Owen Editor's canonical Frosted ScrollArea control.
Code blocks Live Preview copy controls sit 13px from the right code-block boundary while editable titles and copy behavior remain owned by Owen Editor 0.6.34.
Validation Obsidian 1.12.7 runtime checks cover the macOS scrollbar channel, exact copy-button inset, title/copy controls, and clipboard output.

v3.1.98 — Precise Scroll And Vault Alignment

This release restores the canonical Frosted ScrollArea material and places workspace scroll controls and vault actions on their intended channels.

Area What changed
Vault controls Vault switcher, help, and settings controls now keep equal 8px gaps.
File explorer The fixed glass grip returns to the original native scrollbar channel without changing its material or interaction.
Editor palette The scrollbar aligns with the modal's right edge while preserving native wheel, touch, and keyboard scrolling.
Validation Obsidian 1.12.7 runtime measurements confirm 8px/8px control gaps and a 6px palette edge inset with zero positional error.

v3.1.97 — Canonical Scroll And Code Controls

This release connects Owen Editor's canonical Frosted ScrollArea to Obsidian vertical viewports, removes the theme's native scrollbar approximation, and tightens code-block and vault action controls.

Area What changed
Vertical scrolling Owen Editor 0.6.31 preserves native wheel, touch, and keyboard scrolling while adding a fixed glass grip, rail click, and pointer drag.
Scroll surface The interaction rail stays transparent, the workspace separator remains faint, and the grip keeps measured clearance from file-explorer rows.
Code blocks Live Preview adds one-click copying, left-aligned editable titles, compact icons, and one static PDF title.
Vault controls The help and settings buttons keep an explicit 8px gap.

v3.1.96 — PDF And Explorer Clarity

This release removes fixed screen-delivery/report-mode branches, keeps PDF readability independent from paper size, and turns long file-explorer labels plus folder metadata into one coherent tooltip surface.

Area What changed
PDF readability The readability preset adjusts typography and table/code spacing while preserving the selected A4/A3 portrait or landscape page.
Removed modes Fixed 1920×1080, customer-delivery visibility, and bundled report mode options and implementation paths are removed.
File explorer Long top-level and nested folder names stay within the explorer boundary with ellipsis; the native hover tooltip reveals the full title and folder statistics.
Tooltip companion Companion 1.3.0 structures wrapped titles and metadata into one white tonal-gradient balloon with an 800-weight title, measured divider spacing, and a connected triangular tail.
Validation Obsidian 1.12.7 runtime checks cover PDF paper preservation, LP/PDF parity, ellipsis geometry, tooltip content, two-line titles, spacing, and tail attachment.

v3.1.95 — Reliable Style Settings Localization

This release restores Owen Graphite's language selector when Obsidian is Korean but Style Settings cannot resolve its legacy locale key, and fills the new Interface heading's semantic icon tile.

Area What changed
Language selector Automatic (Obsidian), Korean, and English preserve the existing ogd-language-* values.
Compatibility bridge The optional localization companion translates only Owen Graphite rows and Style Settings chrome without modifying Style Settings data.
Interface icon The Interface heading uses the existing semantic icon owner with an 18px Languages glyph and graphite light/dark ink.
Validation Obsidian 1.12.7 runtime checks cover automatic fallback, explicit English/Korean classes, translated labels, and the computed icon mask.

v3.1.94 — Semantic Settings Cards

This release aligns Obsidian's core settings plus Owen Graphite, Owen Editor, and Owen Exporter with the same grouped-card language used by Owen Mermaid while keeping each function visually distinct.

Area What changed
Settings groups Eight Obsidian core tabs plus Graphite, Editor, and Exporter use compact grouped cards with independent 32px icon tiles where native headings exist.
Semantic icons Every section has a purpose-specific Lucide glyph and color instead of a repeated collapse chevron.
Ownership Editor and Exporter expose stable semantic section hooks so the theme does not depend on child position.
Validation Obsidian 1.12.7 runtime checks cover core card counts, icon uniqueness, clipping, overflow, row overlap, and section borders.

Older feature notes are kept in dev/WIKI/DOCS/v3/feature-history.md.


3. Installation Details

Option A — Obsidian Community Theme Browser

  1. Open SettingsAppearanceManage under Themes.
  2. Search for Owen Graphite.
  3. Install and enable the theme.

Option B — Manual ZIP Install

Download Owen-Graphite-3.1.99.zip from the latest release, then extract it into your vault theme folder.

Platform Target path
Windows <YourVault>\.obsidian\themes\Owen Graphite\
macOS / Linux <YourVault>/.obsidian/themes/Owen Graphite/

After extraction, open Obsidian and select Owen Graphite from SettingsAppearanceThemes.

Release assets also include GitHub's generated Source code (zip). Use Owen-Graphite-3.1.99.zip for the installable theme package.

Optional Owen Graphite Companion

Download Owen-Graphite-Companion-1.3.0.zip from the same release when Style Settings needs the Korean locale fallback or when you want wrapped title/metadata tooltips to use the full Owen Graphite hierarchy. Extract its owen-graphite-style-settings-l10n folder into:

<YourVault>/.obsidian/plugins/owen-graphite-style-settings-l10n/

Reload Obsidian, enable Owen Graphite Companion under Community plugins, then choose Settings → Style Settings → Owen Graphite → Interface → Language. The companion preserves tooltip text while separating a wrapped bold title from metadata, and it leaves Style Settings data.json unchanged.

Optional Code-Title Editing

The companion does not edit Markdown. To edit fenced code-block titles directly in Live Preview or Reading View, install Owen Editor 0.6.28 or later. Owen Editor stores the title in Markdown:

```bash title="Package update"
winget upgrade
```

Option C — Git Install Or Update

Clone into .obsidian/themes/Owen Graphite/. Running the same command again updates the theme.

Windows (PowerShell)
$ErrorActionPreference = "Stop"
$Vault = "D:\Path\To\YourVault"            # replace with your vault path
$Repo = "https://github.com/towishy/Owen-Graphite.git"
$ThemesDir = Join-Path $Vault ".obsidian\themes"
$ThemeDir = Join-Path $ThemesDir "Owen Graphite"

New-Item -ItemType Directory -Force -Path $ThemesDir | Out-Null

if (Test-Path -LiteralPath (Join-Path $ThemeDir ".git")) {
  git -C "$ThemeDir" fetch --quiet origin main
  git -C "$ThemeDir" reset --quiet --hard origin/main
  git -C "$ThemeDir" clean -qfd
  Write-Host "OK: Owen Graphite updated."
} elseif (Test-Path -LiteralPath $ThemeDir) {
  $Backup = "${ThemeDir}.backup-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
  Move-Item -LiteralPath $ThemeDir -Destination $Backup
  git clone --quiet $Repo "$ThemeDir"
  Write-Host "OK: Owen Graphite reinstalled. Backup: $Backup"
} else {
  git clone --quiet $Repo "$ThemeDir"
  Write-Host "OK: Owen Graphite installed."
}
macOS / Linux (bash)
set -e
VAULT="/path/to/YourVault"                  # replace with your vault path
REPO="https://github.com/towishy/Owen-Graphite.git"
THEME_DIR="$VAULT/.obsidian/themes/Owen Graphite"
mkdir -p "$VAULT/.obsidian/themes"

if [ -d "$THEME_DIR/.git" ]; then
  git -C "$THEME_DIR" fetch --quiet origin main
  git -C "$THEME_DIR" reset --quiet --hard origin/main
  git -C "$THEME_DIR" clean -qfd
  echo "OK: Owen Graphite updated."
elif [ -e "$THEME_DIR" ]; then
  BACKUP="$THEME_DIR.backup-$(date +%Y%m%d-%H%M%S)"
  mv "$THEME_DIR" "$BACKUP"
  git clone --quiet "$REPO" "$THEME_DIR"
  echo "OK: Owen Graphite reinstalled. Backup: $BACKUP"
else
  git clone --quiet "$REPO" "$THEME_DIR"
  echo "OK: Owen Graphite installed."
fi

4. Developer Workflow

The v3 source lives in src/ and is split into tokens, base, surfaces, chrome, features, themes, and plugins. Build and audit work should use the v3 tools in dev/scripts/.

Task Command
Build bundle python dev/scripts/bundle_v3.pydist/theme-v3.css
Refresh theme.css Copy-Item dist/theme-v3.css theme.css -Force on Windows, or the equivalent copy command on macOS/Linux
Live Preview hit-routing audit python dev/scripts/audit_v3_hit_routing.py
Duplicate selector audit python dev/scripts/v3_audit_duplicate_selectors.py
Unused CSS candidate report python dev/scripts/build_unused_css_report.py
Computed-style fingerprint capture python dev/scripts/capture_computed_fingerprint.py --build v3 --theme {light,dark}
fingerprint diff python dev/scripts/fp_diff_summary.py [--theme dark]
Release ZIP python dev/scripts/build_release.py
Obsidian vault sync python dev/scripts/sync_obsidian_theme.py
Companion test and ZIP python compat/owen-graphite-style-settings-l10n/test.py then python dev/scripts/build_companion_release.py

See CONTRIBUTING.md for contribution details, CHANGELOG.md for release history, and dev/WIKI/DOCS/v3/design-spec.md for the design and validation contract.


5. Support

Owen Graphite is free and open source. If it helps your report, wiki, or documentation workflow, you can support maintenance through GitHub Sponsors.


6. License

MIT — LICENSE