README file from
GithubPropCraft
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/Doneto 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
#readingonto#readand 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/writerinto 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, and2024年1月5日into a consistent2024-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
- Open the PropCraft view from the ribbon or the command palette.
- 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.
- Drag one tag onto another, or use the row menu to rename or merge a property.
- Review the preview, deselect exceptions and resolve conflicts. Check the actual note count before applying.
- 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
- Open Settings → Community plugins in Obsidian.
- Select Browse and search for PropCraft.
- 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.