Folderize

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.