PropCraft

by gua
5
4
3
2
1
Score: 50/100

Description

A visual workbench that cleans up properties and tags across your whole Obsidian vault — merge tags, rename fields, add properties in bulk, and normalize dates. No code, no regex.

Reviews

No reviews yet.

Stats

0
stars
49
downloads
0
forks
7
days
3
days
3
days
5
total PRs
0
open PRs
0
closed PRs
5
merged PRs
0
total issues
0
open issues
0
closed issues
14
commits

Latest Version

3 days ago

Changelog

Added

  • A property value workbench inside the Properties tab: complete value distribution, actual storage type versus the vault-wide declared type, field and list-member views, special-state summaries, selection, search, paging, and per-value note drill-down.
  • Exact, typed multi-value mapping: map several historical values to a standard value in one preview, replace list members in place with order-preserving target deduplication, and fill missing/null/empty-text/empty-list states with explicit targets, including a standalone fill entry for fully-missing properties.
  • Explicit text assistants (trim, lower/upper case) that only produce visible rules for selected text values and protect link-like strings.
  • Explainable type repair: text → number with representation and precision checks, single-value → list wrapping, literal/newline list splitting with optional trimming, and date normalization with interpretation and value-loss confirmations.
  • Independent per-note confirmations for value representation changes and declared-type mismatches that can be confirmed or withdrawn; required checks and unsatisfied ones are tracked separately.
  • Bilingual (English/Simplified Chinese) interface strings for the workbench, mapping, conversion and new issue explanations.

Changed

  • New value operations only ever change note data; the vault-wide types.json declaration is read, never written, and each write re-checks the declaration baseline.
  • New value operations use new operation kinds (mapPropertyValues, convertPropertyType) so 0.1.2 cannot silently retry a new date/type choice; legacy normalizeDate records keep their original structure.
  • Date analysis rejects illegal hours/minutes/seconds and unpreservable time zones or fractions before conversion, sharing one validator across old and new entry points.

Notes

  • YAML comments, quoting and layout may still be reformatted; unaffected values and body text are preserved.
  • Declared types are not migrated: the Properties panel may still show the vault-wide declared type even after note data is changed.
  • Recovery journals remain V2. Unknown operation kinds are read-only and unsupported; downgrading to 0.1.2 cannot restore or retry new value operations.

README file from

Github

PropCraft

A visual workbench that cleans up properties and tags within a chosen set of Obsidian notes — merge tags, rename fields, add properties in bulk, and normalize dates. No code, no regex.

简体中文

Why PropCraft

After a few months of use, a vault fills up with near-duplicates: #reading, #read, and #book all describing the same thing; author, Author, and writer all pointing at a person; dates written five different ways. The built-in property panel only renames one field in one note at a time, and deeper cleanup usually means learning a scripting language or a linter plugin.

PropCraft turns that cleanup into sorting a spreadsheet. Open the workbench, see every property and tag in one place, and fix them with a drag.

Features

  • Choose the notes. Combine a vault folder, tag conditions and property conditions with AND; review matches and exclude individual notes. The scope follows you across the workbench tabs.
  • Everything in one view. Every property key and tag in the vault, with how many notes use it, its value type, and sample values.
  • See every value. Open a property to inspect its complete value distribution, actual storage type versus the vault-wide declaration, and list members, then drill into any value's notes.
  • Map many values at once. Map 已读 / finished / Done to one standard value, replace list members in place, fill missing or empty values, and repair "5" → 5, wrap or split lists, and normalize dates with an explanation for every exception.
  • Spot the mess. Orphan properties used only once, and suspected-duplicate tags or keys (case, singular/plural, separators, typos) are grouped and highlighted.
  • Drag to merge. Drag #reading onto #read and let go. A preview lists every note that will change; confirm once and PropCraft rewrites them in the background.
  • Rename or merge fields. Collapse author / Author / writer into one property, choosing how conflicting values are combined.
  • Bulk add properties. Give every note in a folder a field such as status: unread, all from a guided wizard.
  • Normalize dates. Turn 2024/1/5, Jan 5, 2024, and 2024年1月5日 into a consistent 2024-01-05.
  • Decide per note. Select notes and choose conflict strategies before applying. Unresolved destructive conflicts are skipped; ambiguous dates require confirmation.
  • Recover with evidence. Every batch keeps a local journal. Review undo first; later edits are preserved and partial recovery stays visible. Retry previews include only unfinished paths.
  • Speaks your language. Chinese when Obsidian is in Chinese, English otherwise.

How to use

  1. Open the PropCraft view from the ribbon or the command palette.
  2. Choose the shared note scope in Properties, Tags, or Bulk actions, then review the matched notes. Browse the Properties and Tags views. Open the Suggested cleanups to see orphans and likely duplicates.
  3. Drag one tag onto another, or use the row menu to rename or merge a property.
  4. Review the preview, deselect exceptions and resolve conflicts. Check the actual note count before applying.
  5. If something looks wrong, use Undo in the result panel or the History view.

Compatibility and limitations

Requires desktop Obsidian 1.8.7 or later. Mobile devices are not supported.

PropCraft only changes the metadata and tags you select. It does not rewrite note body text other than inline #tags, and it skips notes whose properties cannot be parsed instead of overwriting them. Property actions protect reserved fields such as tags, aliases, and cssclasses; tag actions update the matching frontmatter tags and body tags together. Notes excluded by settings are never written.

YAML comments, quoting and layout may change during serialization. Unknown or unsafe YAML is blocked. Tag matching ignores case but keeps _ and - distinct; including subtags in a filter does not rename a tag tree.

History limits are checked before any note or type write, including UTF-8 recovery materials and state capacity. At the limit, review History and explicitly remove one eligible completed record, or adjust the limits in Settings. Unfinished and partly recovered records are protected; nothing is automatically pruned. A write with uncertain outcome must be reconciled before retrying. Type dependency checks read metadata across the vault, including excluded notes, without writing those notes.

If an initial state file is missing, History can confirm the checked state without content writes only when all notes match their recorded originals and the type addition needs no recovery. Damaged state files remain read-only.

Upgrading preserves 0.1.1 history. Legacy records without a trustworthy after-content hash remain read-only for changed notes, and do not contain recoverable type snapshots. Recovery of new V2 transactions requires PropCraft 0.1.2 or later; downgrading does not provide V2 undo.

Installation

  1. Open Settings → Community plugins in Obsidian.
  2. Select Browse and search for PropCraft.
  3. Select Install, then Enable.

Privacy

PropCraft works entirely offline. There are no accounts, no network requests, no telemetry, and no access to files outside your vault. Undo history is stored locally in the plugin's own folder.

Support development

PropCraft is free. If it saves you time, voluntary donations are welcome — thank you.

WeChat Pay Alipay

License

MIT © 2026 gua.