FolderMate

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

Description

Obsidian plugin: color a folder and all its subfolders in the file explorer, as text color or fading background bands.

Reviews

No reviews yet.

Stats

0
stars
488
downloads
0
forks
45
days
9
days
9
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
1
total issues
0
open issues
1
closed issues
7
commits

Latest Version

9 days ago

Changelog

  • Fix, typing a new note's name: with "Reveal the open note" on, the cursor could jump out of a new note's title into the file explorer while you typed its name (GitHub issue #1). FolderMate now reveals the note the same way Obsidian's own "Auto-reveal current file" does: it expands the folders and scrolls the note into view, but never moves focus to the explorer.

Also new since 1.0.2

  • Background on by default: new installs color folders with a background band at once. Existing setups keep their saved choice.
  • Indent line opacity: a new slider (10 to 100%) beside the indent line thickness, to make the lines fainter.

README file from

Github

FolderMate

Color your folders. Find anything at a glance.

A big vault turns the file explorer into a wall of identical grey rows. FolderMate lets you give a folder a color, and every subfolder and note inside it follows along. Right-click, pick a color, done.

FolderMate coloring folders in the file explorer

What it does

  • Right-click to color. Set folder color sits in the folder menu. Pick from your own palette.
  • Subfolders follow along. Everything inside a colored folder takes its color. Give a subfolder its own color and it starts a new group.
  • Two looks. Color just the folder names (text mode), or draw rounded background bands that fade a little with each level.
  • Notes sit on their folder's color. An optional soft block behind a folder's contents shows what belongs where.
  • Make it yours. Your own palette, depth fade, bold folder names, indent lines, file name color and active-note colors.
  • Works with light and dark themes.
  • Searchable settings. Find any FolderMate option from Obsidian's settings search.

Right-click a folder, pick a color

Subfolders inherit their parent's color, or start their own group

Text mode, background bands, and a light theme

FolderMate settings: palette, fade and active-note colors

How to use

  1. Install FolderMate from Settings > Community plugins and enable it.
  2. Right-click any folder in the file explorer and choose Set folder color.
  3. To switch looks or edit the palette, open Settings > FolderMate.
  4. To take a color off, right-click the folder and choose Remove folder color.

If you use another plugin that colors the file explorer, turn it off. Both would style the same rows.

Privacy and safety

  • Your notes never change. Colors live in the plugin's own data.json. Rename or move a folder and its color goes with it.
  • No network, no telemetry. It also has no runtime dependencies.
  • Folder paths only. It reads folder paths and never opens a note's contents.
  • Checked colors. A color must be a valid #RRGGBB value before it reaches the page.
  • Desktop only. Needs Obsidian 1.13 or later.
  • Signed releases. Every release is built by GitHub Actions from this repository and carries a build provenance attestation.

Support

If FolderMate makes your vault a little nicer, you can buy me a coffee. Thank you!

Develop

npm ci, npm test, npm run lint, npm run build (installs into ../test-vault), npm run obsidian:check (live checks in a real Obsidian), npm run showcase (store screenshots), npm run ship.

MIT licensed. Made by Droid.