mirror of
https://github.com/gansxx/auto-folder-tags.git
synced 2026-07-22 07:31:58 +00:00
No description
| .github/workflows | ||
| src | ||
| submission | ||
| .gitignore | ||
| esbuild.config.mjs | ||
| LICENSE | ||
| manifest.json | ||
| package-lock.json | ||
| package.json | ||
| preview-in-sandbox.js | ||
| README.md | ||
| tsconfig.json | ||
| version-bump.mjs | ||
| versions.json | ||
Auto folder tags
Automatically apply configured tags to new notes and supplement tags for files in the current folder.
Features
- Listen for newly created markdown files and inject configured frontmatter tags.
- Apply the same configured tags to all markdown files in the current folder from the command palette.
- Avoid duplicate tags when the note already contains some or all target tags.
Installation
Manual install
- Download
manifest.jsonandmain.jsfrom the latest GitHub release. - Create the folder
.obsidian/plugins/auto-folder-tags/inside your vault. - Move the release files into that folder.
- Reload Obsidian and enable Auto folder tags in Settings -> Community plugins.
Community plugins
After the plugin is approved by the Obsidian team, it will be installable from the in-app community plugins browser.
Configuration
- Open Settings -> Community plugins -> Auto folder tags.
- Add one or more rules.
- Set each folder path relative to the vault root, for example
InboxorProjects/ClientA. - Enter tags as comma-separated values, for example
tag1, tag2.
The plugin uses the longest matching folder rule. A rule for Projects/ClientA overrides a broader rule for Projects.
Commands
Apply configured tags to files in the current folderOpen auto folder tags settings
Privacy and disclosures
- The plugin works locally inside the vault.
- It does not send note content, filenames, or telemetry to external services.
- It does not require any cloud account or network access for normal operation.
Development
- Run
npm install - Run
npm run check - Run
npm run devwhile developing - Run
npm run buildfor a production bundle
Release and submission
- The repository includes GitHub Actions for CI and release asset uploads under
.github/workflows/. - The release workflow also generates GitHub artifact attestations for the uploaded release assets.
- The submission helper files live in
submission/. - Release tags must exactly match
manifest.jsonversion, for example0.0.1.
Sandbox preview
The preview helper defaults to the Obsidian Sandbox vault under %APPDATA%.
node preview-in-sandbox.js --enable-plugin
Use a different vault only when needed:
node preview-in-sandbox.js --vault-path "D:\\My Vault"