Python client for ETAPI of Trilium Note.
- ๐ trilium-py
- ๐ฆฎ Table of Contents
- ๐ง Installation
- ๐ (Basic) Usage
- (Advanced Usage) โ TODO List
- (Advanced Usage) ๐ Upload Markdown files
- ๐ ๏ธ Develop
- ๐ Original OpenAPI Documentation
python3 -m pip install trilium-py --user
These are basic function that Trilium's ETAPI provides. Down below are some simple example code to use this package.
If you have a ETAPI token, change the server_url
and token
to yours.
from trilium_py.client import ETAPI
server_url = 'http://localhost:8080'
token = 'YOUR_TOKEN'
ea = ETAPI(server_url, token)
If you haven't created ETAPI token, you can create one with your password. Please note, you can only see this token once, please save it if you want to reuse the token.
from trilium_py.client import ETAPI
server_url = 'http://localhost:8080'
password = '1234'
ea = ETAPI(server_url)
token = ea.login(password)
print(token)
After initialization, you can use Trilium ETAPI with python now. The following are some examples.
To start with, you can get the application information like this.
print(ea.app_info())
It should give you the version of your server application and some extra information.
Search note with keyword.
res = ea.search_note(
search="python",
)
for x in res['results']:
print(x['noteId'], x['title'])
You can create a simple note like this.
res = ea.create_note(
parentNoteId="root",
title="Simple note 1",
type="text",
content="Simple note example",
noteId="note1"
)
The noteId
is not mandatory, if not provided, Trilium will generate a random one. You can retrieve it in the return.
noteId = res['note']['noteId']
Image note is a special kind of note. You can create an image note with minimal information like this. The image_file
refers to the path of image.
res = ea.create_image_note(
parentNoteId="root",
title="Image note 1",
image_file="shield.png",
)
To retrieve the note's content.
ea.get_note_content("note1")
You can get a note metadata by its id.
ea.get_note(note_id)
Update note content
ea.update_note_content("note1", "updated by python")
Modify note title
ea.patch_note(
noteId="note1",
title="Python client moded",
)
Simply delete a note by id.
ea.delete_note("note1")
You can get the content of a certain date with get_day_note
. The date string should be in format of "%Y-%m-%d", e.g. "
2022-02-25".
es.get_day_note("2022-02-25")
Then set/update a day note with set_day_note
. The content should be a (html) string.
self.set_day_note(date, new_content)
Export note comes in two formats html
or markdown
/md
.
res = ea.export_note(
noteId='sK5fn4T6yZRI',
format='md',
savePath='/home/nate/data/1/test.zip',
)
With the power of Python, I have expanded the basic usage of ETAPI. You can do something with todo list now.
You can use add_todo
to add a TODO item, param is the TODO description
ea.add_todo("ไนฐๆๅฎๅฎ")
param is the index of the TODO item
ea.todo_check(0)
ea.todo_uncheck(1)
Use update_todo
to update a TODO item description at certain index.
ea.update_todo(0, "ๅป็ ๅคดๆด็น่ฏๆก")
Remove a TODO item by its index.
ea.delete_todo(1)
As the title suggests, you can move yesterday's unfinished things to today. Unfinished todos will be deleted from yesterday's note.
ea.move_yesterday_unfinished_todo_to_today()
You can import Markdown file with images into Trilium now! Trilium-py will help you to upload the images and fix the links for you!
res = ea.upload_md_file(
parentNoteId="root",
file="./md-demo/manjaro ไฟฎๆนcaps lock.md",
)
You can upload a folder with lots of Markdown files to Trilium and preserve the folder structure!
Say, upload all the notes from VNote, simply do this:
res = ea.upload_md_folder(
parentNoteId="root",
mdFolder="~/data/vnotebook/",
ignoreFolder=['vx_notebook', 'vx_recycle_bin', 'vx_images', '_v_images'],
)
res = ea.upload_md_folder(
parentNoteId="root",
mdFolder="/home/nate/data/logseq_data/",
ignoreFolder=['assets', 'logseq'],
)
Obsidian has a very unique linking system for files. You should use obsidian-export to convert a Obsidian vault to regular Markdown files. Then you should be able to import the note into Trilium with trilium-py.
Convert it first.
obsidian-export /path/to/your/vault /out
Then import just like a normal markdown, trilium-py will handle the images for you.
res = ea.upload_md_folder(
parentNoteId="root",
mdFolder="E:/data/out",
)
Youdao does not provide an export feature anymore. Luckily, you can use https://github.com/DeppWang/youdaonote-pull to download your notes and convert them into markdown files. After that, trilium-py should be able to help you import them.
res = ea.upload_md_folder(
parentNoteId="root",
mdFolder="/home/nate/gitRepo/youdaonote-pull/out/",
)
In general, markdown files have variety of standards. You can always try import them with
res = ea.upload_md_folder(
parentNoteId="root",
mdFolder="/home/nate/data/your_markdown_files/",
)
If there is any problem, please feel free to create an issue.
Install with pip egg link to make package change without reinstall.
python -m pip install --user -e .
The original OpenAPI document is here. You can open it with swagger editor.