README file from
GithubFolderize
An Obsidian plugin that automatically organizes your attachments into a structured folder hierarchy based on file content checksums.
Purpose
Managing attachments in Obsidian can become unwieldy as your vault grows. The Folderize plugin solves this by organizing your attachments into a predictable, content-based folder structure. Instead of having all attachments in a single folder or manually organizing them, Folderize creates a hierarchical directory structure based on each file's SHA-256 checksum.
This approach ensures:
- Consistent organization: Files are always placed in the same location based on their content
- Deduplication: Identical files will be placed in the same folder path
- Scalability: The folder structure distributes files evenly, preventing any single directory from becoming too large
- Automation: Set it and forget it - new attachments can be organized automatically
How It Works
Folderize calculates a SHA-256 checksum for each attachment and uses the first few bytes of the hash to create a nested folder structure. For example, with the default depth of 4, a file might be organized into:
Attachments/
├── a1/
│ ├── b2/
│ │ ├── c3/
│ │ │ ├── d4/
│ │ │ │ └── my-image.png
Configuration
The plugin provides several configuration options in Settings > Plugin Options > Folderize:
Basic Settings
- Attachment path: The root folder where attachments are stored (default: "Attachments")
- Auto-organize: Automatically organize new attachments as they're added to your vault
- Remove empty folders: Clean up empty directories after reorganizing files
Advanced Settings
- Path depth: Number of directory levels to create (1-8, default: 4)
- Log level: Adjust console logging verbosity for debugging
Usage
Manual Organization
Use the command palette (Cmd/Ctrl + P) and search for "Organize all attachments" to manually organize all files in your attachment folder.
Automatic Organization
Enable "Auto-organize" in the settings to have new attachments automatically organized when added to your vault.
Installation
Installation is supported using BRAT.