Folder Note Plugin: Add description note to folder

I’d prefer not to try to do this via discord; the bandwidth is too low unless synchronous.

As far as collaboration goes, my philosophy of plugins is that as much as possible, they should be small and aimed at synergy with other plugins rather than taking on all possible aspects of a task, especially if it results in a lot of UX choices that different people may not agree on.

This is especially true when dealing with something like folder notes, where the underlying thing is really a convention or agreement of structuring things in a vault, but the specifics of how people want to work with them is different. When plugins combine core functionality with UX extensions in the same plugin, it makes it harder for end users to mix and match features.

My kind of philosophy for plugins related to folder notes is more similar to how Calendar, Periodic Notes, Natural Dates, etc. work together: there is a core plugin (Periodic Notes) that provides configuration and an API for working with it, there are UI plugins you can take or leave, and then other plugins that optionally integrate with that ecosystem.

In the folder note space, it would be nice to have a folder note plugin with slightly more functionality than NFA does right now, with configuration and an API, and file-menu operators for the basic creation and automove/rename of folder notes. Rather than doing any templating, it would instead fire an event to notify other plugins of a folder note being created, allowing them to provide or alter the text. Rather than manipulating the built-in file explorer, it would provide a utility API to get the note (if any) for a folder, or the target path for creating one, so that file explorer extensions don’t have to duplicate configuration and code.

Then, other plugins can exist to change how the builtin explorer works, to provide templates or fancy views, and of course other plugins can use it to provide special features the way Quick Explorer does. Plugins that want to do things involving folder notes would just defer to and depend on this central plugin rather than duplicating the functionality in a mutually incompatible way with one another.

In this way, user choice and plugin flexibility is massively increased, because people can pick and choose the pieces of their solution. For example, templater plus dataview to create default folder notes, and so on, or different approaches to integrating with the file explorer.

My current plan was to create a successor to NFA, Folder Note Manager, with the above core functionality, an npm API, and a way to access that API from other plugins that doesn’t depend on accessing Obsidian’s internal plugin structures or redeclaring types. The specific functionality would be to do what NFA does, but with a choice of folder note strategies, and the option to do bidirectional autorename, not just the unidirectional it does now. There would be another command to unmake a folder note, a folder context menu item to create a folder note (with an event hook for templates or macros), and a file context menu item to turn a note into a folder.

The main reason I was thinking of doing this is that I want Quick Explorer to support creating folder notes, but it’s currently using a hardcoded strategy and I really don’t want to end up with a monolithic thing that forces one strategy or competes with other choices in this area. So my thought is that by making FNM (folder note manager) to implement a mostly-UX-choices-free system for managing folder notes, then QE and other plugins can build on top of that.

1 Like

Agreed, I’ve already worked like this when developing breadcrumb-nav, access plugins via API. I’ve even submitted PRs for dataview api types. For folder note, the code structure is rather modular so it should be easy to be migrated. But Licat will has some work to do to make users less confused when there are so many options available :joy:. So I’ll create a parallel project like folder-note-core and migrate the code to there. Most of the functions you need is in commands.ts, find.ts and vault-handler.ts, I’ll invite you as a collaborator when the repo is created.

And for Quick Explorer, is it possible to collaborate so that I can migrate some features from my project to yours, like support for breadcrumb syntax? The relation-resolver is implemented similar to your idea. I won’t have too much time to maintain so many dedicated projects in the future so I think it’s better to get them working on Quick Explorer.

For folder notes, I thought my previous comment was clear: at some point I will be making FNM with the features I described, unless somebody makes it first. I’m not interested in direct collaboration on any project, just co-ordination between projects or the occasional PR. Or if your folder-note-core provides a sufficient API and features before I get around to it, then there’s no need for me to write FNM and I’ll just integrate with that. Otherwise I’ll get to it when I get to it.

Regarding breadcrumbs, I’m not sure I follow how that would integrate w/QE. QE does folder navigation, not link navigation, and I wasn’t able to find any documentation or information on your nav plugin or relation-resolver outside the code itself, which I don’t have time to dig into at the moment.

Got it. Will send you the link when folder-note-core is available.

For breadcrumb-nav, it’s still under development and the document is not ready yet. A demo video is already sent over discord. In short, it can display virtual paths based on inline fields inside notes (like parent::[[some file]]) that do not exist in the file system. It can use folder note to as a bridge between virtual path and file path, for example, put all notes under a folder with linked note and specify hierarchy in notes without actually create folders.

I believe I saw the demo, but I still don’t understand how it works or what it’s for, let alone how it would interact with QE. I have thought about adding a feature to QE to allow browsing a file’s links or backlinks as a submenu, but I doubt that would really replicate what you have in mind, even though I’m not precisely sure what it is you do have in mind.

Now that I’m thinking of it, being able to navigate to the tags in a file, and from tags to the files that contain them might be cool too… ah well, something for later. :slight_smile: If I figure that out, then I might be able to come up with a way to define other virtual paths for the breadcrumbs, and thus support your breadcrumb model, whatever that is.

But that is some ways away, as right now QE is very tightly coupled to having menu items be file/folder objects and a fairly rigid navigation hierarchy.

Currently, Obsidian sorts folders and files separately.
The Alx-Folder-Note plugin could benefit from “Same sort order for folders and files”.
Because “folders~notes” can be worth the place of a note within a tree structure.
I believe Trilium allows this kind of sorting.
Wikipad has a tree structure by nodes.
This is up to everyone’s preference, but one can benefit from such an organization of things.
Is this a possibility taken into account in the evolution of the Alx-Folder-Note plugin? Or more generally Osidian, or a plugin specific to triage?

Thank you for bringing us such a good plugin, I would like to know if it is possible to “move note to this folder” while “make note to folder”? This feature can be implemented by Note folder Autorename, but it doesn’t work on iphone. I look forward to your reply!

I’m suuuper late to the party, but thank you so much for working on this plugin!

Thanks a lot for the plugin, it’s really practical for some of my folders.

There’s one thing I’m wondering, is there a way to affect the colors used by the headers in the cards vault-wide ?
I understand it’s possible to do card by card in the ccard syntax but I can’t find a way to do it for all cards generated by the plugin.

image

For example this red background doesn’t fit with my theme at all, but I don’t know how to change it. The rest of the colors seem to be affected by the theme but not this one.

How do you get dataview to ignore the folder note in queries?

2 Likes

This plug in is great for helping to mimic the feel of Scrivener, thank you.

Is there a way to shrink the card view so that the contents aren’t the normal large headings size, without having to modify headings everywhere?

And probably a bit of a tangent but since other people here may have solved it already - single-clicking on a folder in the explorer on the left always collapses or expands it. Is there a way to change that to require a double click, so that I can click a folder to read its note without having it open/shut the folder?

Edit: Ah, I see, Aidenlx’s Folder Note allows that.

1 Like

Hi @xpgo ,

I have been using this plugin for a long time and find it extremely useful for organising my notes.

But now after the release of Obsidian canvas, I think it would be great if we can also set a canvas as a folder note.

Currently, if I set identical names for a .canvas file and it’s parent folder, the file gets hidden in the file-explorer but clicking the folder does not redirect to the canvas file.

I glanced at the source-code and it seems that simple modifications to the folder-note.ts file can make this work. Not sure though.

Can I expect this feature in one of the upcoming releases?

Thanks

I really enjoy the Folder Note plugin, and it meshes perfectly with how I organize my notes (I prefer hierarchies over links).

I’m wondering if anyone knows a way to change the behavior of the file explorer to work better with Folder Note; the way it works currently is somewhat distracting.

In the file explorer you have:

> Foldername

When you click on any part of > Foldername, it opens the hierarchical list of all files in the folder; this is distracting if you are using Folder Notes to navigate since you want to see your top level folders only. I’m wondering if there’s a way to split the behavior, so that when you click the > it open the hierarchical list, but when you click Foldername, you open only the Folder Note?

Hi @exaltcovert ,

are you committed to stick with the original @xpgo Folder Note plugin or are you open to give a try to a newer (and maintained) equivalent plugin? If the latter, please take a look at AidenLx’s Folder Note: https://github.com/aidenlx/alx-folder-note. It was already mentioned in this thread and it works exactly as you described: click on > expands or collapses the hierarchy (and does not change the focus) while clicking on folder name opens the folder note and sets focus to it.

3 Likes

Ah, thank you! I learned about Folder Note from somewhere else, and didn’t realize there was a newer plugin. I installed Aidenlx’s and it works exactly how I wanted :slight_smile:

1 Like

Thank you so much for this Plugin, I am new to Obsidian and was quite annoyed that this wasn’t a feature, but this has been really great to use and perfectly solved my problem!

I do have one question however, I am not able to create a folder note out of an existing folder like the wiki suggests, am I just looking in the wrong place? Neither of the highlighted options seem to work…

Here is my right click menu and more options menu as well, I can see the reveal file in navigation option, so I know the plugin is working, but I cannot see the Make Doc Folder Note option:
image

Either way, even if this isn’t a feature, this is a wonderful plugin that makes the exiepernce much better, so thank you very much!!

Hi,
Is anyone else having an issue with AidenLx’s Folder Note? I am unable to click the folder notes in the file tree, I can only browse the file tree the old fashioned way. This is happening on both OSX and mobile, with the Minimal theme. I’m on the latest version of Obsidian and all the plugins are updated.

Hi @exaltcovert,

this problem is known, reported and discussed in github under #134: Folder notes no longer open when clicking on the folder (Obsidian Desktop v1.5.4)

To simplify the life of not advanced users I’ve recently created a patched copy of the alx-folder-note and exposed it for easy installation with the well known BRAT plugin. The repository name to use in BRAT is https://github.com/SebastianMC/alx-folder-note.

All details and the background are clarified in my comment under #134 and in the updated readme of GitHub - SebastianMC/alx-folder-note

Hopefully this will make our life easier until the author applies relevant fixes onto the main repository.

1 Like

As a workaround, I’ve found right-clicking on the folder and selecting “open folder note” does the job.

Thank you so much!