How to run the Trilium-SingleFile plugin?

[SunriseWind]

Hello. The installation process for the Trilium-SingleFile plugin is obscure. The developer has written only two poor and insufficient instructions for installing Trilium-SingleFile.

https://github.com/zerebos/Trilium-SingleFile

Installation :
Download the zip file from the latest release on GitHub.
Import the zip into Trilium, but make sure you uncheck Safe Import!

He absolutely did not explain how to create relationships in notes (renderNote), nor the other labels necessary for the plugin to work!

I successfully imported the plugin into Trilium by disabling "Safe Import!"

What do I need to do next to use the plugin?

[dosubot[bot]]

Hi @SunriseWind! I'm Dosu and I’m helping the Trilium team.

After importing the Trilium-SingleFile plugin with "Safe Import" unchecked, here’s how to get it working:

1. Create a new note named Trilium SingleFile. This will act as your render note (container for imported web pages).
2. When you import SingleFile HTML pages (by dragging them into Trilium or using the plugin’s file watcher), the plugin will automatically place them in a note labeled #singleFileInbox (or fallback to #inbox or your daily note) and tag them with #singleFileSource. The render note gets the #singleFilePreview label.
3. You don’t need to manually create relationships or labels for each imported page—the plugin handles this as long as you use the render note as the drop target.
4. To set up automatic imports, open the plugin’s UI in Trilium and configure the file watcher to monitor a folder where your SingleFile HTML exports are saved. The plugin will then import new files from that folder automatically.

If you want to tweak how imported pages look in previews, consider adding a screenshot image at the top of each note for a better thumbnail, since Trilium’s preview cards show the first image clearly. The plugin does not provide detailed documentation for manual relationship setup, but using the render note and letting the plugin manage labels is the intended workflow.
Reference

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[SunriseWind]

This is gibberish. What you wrote makes absolutely no sense.

How do I get the plugin's HTML file import page to appear?

[SunriseWind]

How to open the plugin user interface?

[eliandoran]

I successfully imported the plugin into Trilium by disabling "Safe Import!"

Judging by the screenshot, you accidentally imported the source code of the repo and not the .zip file that needs to be imported. You should download it from https://github.com/zerebos/Trilium-SingleFile/releases/tag/v0.1.1 (first artifact, not the source code).

As for the other steps, I can't offer support since I haven't used this plugin.