trilium-translation

🌏 Trilium Translation

The translation code for Trilium by Zadam has been saved to this fork: https://github.com/Nriver/trilium-translation/tree/zadam-version

This repository will now focus on developing a modified version of Trilium.

Star this repo if you like it, thx :)

📱 Recommendation for Android Users:

If you use Trilium on your phone or tablet, I strongly recommend trying Pocket Trilium — an Android client I developed specifically optimized for mobile devices.

👉 https://github.com/nriver/pocket-trilium

If you have old data, PLEASE BACK UP YOUR DATA BEFORE USE.

🦮 Table of Contents

• 🌏 Trilium Translation
• 🦮 Table of Contents
• 📸 Screenshots
• 📚 How to use
• 🐳 How to run server with docker
• 🌐 How to translate
  • 🌐 How does the translation work
    • 💻 Compile Environment Requirement
    • 🔍 Translate Process
    • 📝 More text to translate
• 🛑 Limitations
• 🤔 Common questions
  • Which VPS provider are you using to run the Trilium Notes server?
  • Some Questions Regarding Domain Names
    • How to Enable HTTPS Encryption?
    • Where Did You Purchase Your Domain?
    • How to Apply for a Website Certificate?
  • Why my translation is not working?
  • Where is the Note Database?
    • Default Paths for Client Databases
    • Default Path for Server Database
  • How to Change the Database Location?
• ⏳ Stargazers over time
• 💰 Donation
• 🙏 Thanks

---

📸 Screenshots

Original dark theme

Original light theme

Nier theme made by me :)

Canvas Note

Math formular

---

📚 How to use

1. Download from the latest Release that suit your computer system.
2. Unzip and execute(trilium for Linux, trilium.sh for Linux server, trilium.exe for Windows, trilium.app for macOS).
3. Enjoy :)

🐳 How to run server with docker

For Trilium Notes server, you can download my docker-compose.yml Then run it with docker simply by executing:

docker-compose up -d

It will download the Chinese version of Trilium I built on Docker Hub.

Open http://127.0.0.1:8080 in your browser to access the server page.

Your note data will be in the same directory of the docker-compose.yml file.

---

🌐 How to translate

If you would like to check the code (my codes comes with Chinese and English comments, check it) and compile it by yourself. Here is some information may be useful.

WARNING! The scripts I wrote includes some 'rm -rf' commands, modify and use codes with care!

🌐 How does the translation work

It extracts the resource files from the latest Trilium Notes official release and use regular expression to replace UI text for each file. Then pack the translated files back into the package. Done.

💻 Compile Environment Requirement

My environment is Manjaro(Linux) based, but you can make some change to work on other platform. You need to change some path configuration in my code to work on your machine.

Python3 with module

pip3 install requests --user

Nodejs with module

npm install -g asar webpack webpack-cli
npm install webpack --save-dev

7z if you want to make release

🔍 Translate Process

1. Modify configurations in settings.py by the comments.
2. Do translate in translations.py. (See translations_cn.py. There are over 1000 lines to translate, be patient :) )
3. Run python3 init.py to download latest Trilium Notes.
4. Run python3 trans.py to make a translation patch.
5. Run python3 make_release.py to apply patch to releases for all platforms.

Note: In translations.py there are some texts begin or ends with quotes were made on purpose for regex match, do not remove them in your translation. There are some text like '${xxxx}' in the translation, these are the placeholder in the original Trilium Notes source code, do not modify them unless you know what you are doing.

📝 More text to translate

If you'd like to translate more text, mark each text in the file that you want to translate with double brackets{{}} like I did in trans.py.

Put everything between double brackets into the dict in translations.py and translate to the language you like. (Some text were ended with }. Try to avoid triple brackets by change from ${xxx}}}' to something like ${xxx}'}} )

---

🛑 Limitations

The translation is hard-coded in the frontend/backend source code, so you can not switch between languages. If there were some mistakes in the translation, Trilium Notes may not function correctly. Therefore, please back up your data before use.

If you break Trilium Notes somehow, you need to redownload everything with init.py.

---

🤔 Common questions

The following are some representative questions that I feel are frequently asked by users, so I'll summarize them.

Which VPS provider are you using to run the Trilium Notes server?

I'm using Racknerd now. It's insainly cheap. And very suitable to host Trilium Server.

Racknerd's promotions seem to be ongoing, and you can always purchase them. If you're interested, you might want to give it a try. The links include an affiliate code, which you can remove if you prefer.

I've tested Trilium's server program, and it typically consumes around 150MB of memory. So, the cheapest level would be sufficient, which costs only $10 per year. If you find the storage is not enough for you, you can try the slightly more expensive option, which is usually less than $20 per year and can provide you with about 30GB of SSD storage.

Promotion	RAM	CPU	SSD	Bandwidth	Price	Purchase
2025 Black Friday	1G	1 Core	25G	2T/Month	$10.60/Year	Link
2025 Black Friday	2.5G	2 Core	45G	3T/Month	$18.66/Year	Link
(expired) 2025's 11.11	1G	1 Core	20G	3T/Month	$10.76/Year	Link
(expired) 2025's 11.11	2G	2 Core	35G	5T/Month	$17.66/Year	Link
(expired) 2025 New Year	1G	1 Core	24G	2T/Month	$11.49/Year	Link
(expired) 2025 New Year	2G	1 Core	40G	3.5T/Month	$17.38/Year	Link
(expired) 2024 Black Friday	1G	1 Core	20G	1.5T/Month	$10.99/Year	Link
(expired) 2024 Black Friday	2G	2 Core	40G	3T/Month	$18.93/Year	Link
(expired) 2024's 11.11	1G	1 Core	14G	2T/Month	$11.11/Year	Link
(expired) 2024's 11.11	2G	1 Core	25G	3T/Month	$17.98/Year	Link
(expired) 2024 Dragon Boat Festival	1.25G	1 Core	20G	2TB/month	$12.88/year	Link
(expired) 2024 Dragon Boat Festival	2G	2 Cores	30G	4TB/month	$19.88/year	Link
(expired) 2024 Chinese New Year	1G	1 Core	15G	2T/Month	$10.99/Year	Link
(expired) 2024 Chinese New Year	1.5G	1 Core	25G	4T/Month	$16.88/Year	Link
(expired) 2024 New Year	768M	1 Core	21G	1T/Month	$11.49/Year	Link
(expired) 2024 New Year	2G	1 Core	35G	2.5T/Month	$17.38/Year	Link
(expired) 2023 Black Friday	768M	1 Core	15G	1T/Month	$10.18/Year	Link
(expired) 2023 Black Friday	2G	1 Core	30G	2.5T/Month	$16.98/Year	Link

I’ve been using this VPS provider for several years, and it has always been stable with an unchanged renewal price.

I used to have the 2022's 11.11 plan, which cost $11.11 per year. Now I’ve switched to the 2025's 11.11 plan, where the storage has increased from 11.11 GB to 20 GB — much better for running a Trilium Notes server. Previously, due to limited disk space, I had to disable the note backup feature. With the extra space now, I can finally turn backups back on without worry.

You can also choose other VPS providers, but remember to back up your data. Data is priceless. Make sure to perform backups just in case, and keep it in mind.

Some Questions Regarding Domain Names

How to Enable HTTPS Encryption?

In general, HTTP requests accessed through ports are plaintext. If you need to use HTTPS encryption, it must be used in conjunction with the domain.

Where Did You Purchase Your Domain?

I purchased my domain from Namesilo, and the prices are quite reasonable. Feel free to give it a try if you're interested. Below is the link with an affiliate tag; you can remove it if you prefer. Additionally, there is a coupon code nriver that can save you $1 on your first domain purchase.

Domain Purchase Link

How to Apply for a Website Certificate?

As for website certificates, you can use the free acme.sh tool. For specific instructions, you can refer to the acme.sh documentation on certificate issuance.

Why my translation is not working?

If you have run the original version of the Trilium program and there is a cache of the English version in your system, please follow these steps:

1. Close Trilium.
2. On Windows, delete the directory C:\Users\Username\AppData\Roaming\Trilium Notes.
3. On Linux, delete the directory ~/.config/Trilium Notes/.
4. Restart Trilium, and it will be in your translated language.

Where is the Note Database?

Default Paths for Client Databases

• Windows: C:\Users\Username\AppData\Roaming\trilium-data
• Linux: /home/Username/.local/share/trilium-data
• Mac: /Users/Username/Library/ApplicationSupport/trilium-data

Default Path for Server Database

• Linux Server: /home/Username/trilium-data
• Docker: In the trilium-data folder in the same directory as docker-compose.yml

How to Change the Database Location?

You can refer to the client's built-in trilium-portable.sh or trilium-portable.bat to run it in a portable manner. To change the database location, simply modify the database path in the file.

If you want to experience the latest original features, it is recommended to use this method.

How to Clip Web Pages to Trilium? The Trilium Web Clipper Extension for Chrome Is No Longer Available

Trilium Web Clipper is a browser extension that allows you to save web content directly to Trilium Notes. However, the original version of the extension has not been maintained for a long time and no longer complies with Chrome's latest Manifest V3 standard. As a result, it is no longer available for download from the Chrome Web Store.

To address this, I forked the original project and updated it for Manifest V3 compatibility. I also added support for the Chinese interface and fixed several bugs. You can find more details on the project page: Trilium Web Clipper Plus.

How to escape from the code block?

---

⏳ Stargazers over time

Generated by caarlos0/starcharts.

---

💰 Donation

Hello! If you appreciate my creations, kindly consider backing me. Your support is greatly appreciated. Thank you!

Alipay:

Wechat Pay:

Ko-fi:

---

🙏 Thanks

Thanks t**e for donating 20 CNY!

Thanks 1*0 for donating 8 CNY! Memo: 蜜雪冰城

Thanks **钧 for donating 38 CNY! Memo: 咖啡

Thanks *风 for donating 25 CNY!

Thanks **进 for donating 25 CNY!

Thanks *军 for donating 18 CNY! Memo: 七分甜

Thanks **逸 for donating 10 CNY!

Thanks **恩 for donating 30 CNY!

Thanks *记 for donating 10 CNY! Memo: 多谢大佬的辛勤付出

Thanks *建 for donating 200 CNY! Memo: trilium

Thanks *称 for donating 10 CNY!

Thanks **逸 for donating 10 CNY! Memo: 大佬牛逼

Thanks *斌 for donating 10 CNY!

Thanks *僧 for donating 30 CNY! Memo: 加油，老哥！

Thanks *天 for donating 9 CNY!

Thanks *均 for donating 30 CNY! Memo: 翻译辛苦了，喝杯咖啡

Thanks A*s for donating 30 CNY!

Thanks **逸 for donating 20 CNY!

Thanks *臾 for donating 30 CNY!

Thanks *冰 for donating 10 CNY!

Thanks *遥 for donating 10 CNY! Memo: 感谢群主的翻译

Thanks **庆 for donating 10 CNY!

Thanks **逸 for donating 50 CNY!

Thanks **聪 for donating 10 CNY! Memo: 很大的帮助翻译家！爱来自中国

Thanks **奇 for donating 20 CNY!

Thanks *磊 for donating 10 CNY!

Thanks *姆 for donating 5 CNY!

Thanks **锐 for donating 20 CNY! Memo: 感谢您的工作，请您喝杯咖啡

Thanks **行 for donating 10 CNY! Memo: 小葱白贡献绵薄之力

Thanks 鞠*M for donating 10 CNY! Memo: 感谢大佬，请喝水

Thanks *🐈 for donating 10 CNY!

Thanks *白 for donating 10 CNY! Memo: 小葱白献上

Thanks *白 for donating 5 CNY! Memo: 小葱白献上

Thanks *杜 for donating 20 CNY! Memo: 谢谢您的翻译

Thanks *伟 for donating 20 CNY!

Thanks *淼 for donating 10 CNY! Memo: 今天第一天下载使用，感觉发现新大陆，谢谢！（希望入群交流）

Thanks *落 for donating 10 CNY! Memo: 感谢长期的坚持♥

Thanks *F for donating 99 CNY! Memo: 感谢分享 希望深度合作 长期学习交流

Thanks *F for donating 200 CNY! Memo: Best wishes

Thanks F*g for donating 10 CNY!

Thanks **逸 for donating 30 CNY! Memo: 来杯奶茶，哈皮一下

Thanks *绿 for donating 20 CNY! Memo: 多谢,学生能力有限，尽一份心意

Thanks *户 for donating 20 CNY!

Thanks *孤 for donating 20 CNY! Memo: 请群主大大喝杯奶茶

Thanks X*H for donating 10 CNY!

Thanks **辉 for donating 20 CNY! Memo: 感谢大佬，辛苦了

Thanks *卫 for donating 50 CNY! Memo: 希望能保持更新

Thanks **鄂 for donating 10 CNY!

Thanks **幻 for donating 10 CNY!

Thanks C*W for donating 50 CNY!

Thanks *超 for donating 10 CNY!

Thanks *磊 for donating 30 CNY!

Thanks **龙 for donating 200 CNY!

Thanks *平 for donating 20 CNY!

Thanks *燃 for donating 66 CNY!

Thanks **喜 for donating 10 CNY!

Thanks *君 for donating 28 CNY!

Thanks S*o for donating 38 CNY! Memo: 群主辛苦，请喝杯咖啡

Thanks **厅 for donating 10 CNY! Memo: 沉浸在知识的整理，特别感谢中文版

Thanks **泳 for donating 30 CNY!

Thanks **宣 for donating 99 CNY!

Thanks R*r for donating 10 CNY! Memo: Thanks for copy code for trilium!

Thanks *衣 for donating 6 CNY! Memo: 感谢大佬

Thanks **辰 for donating 0.88 CNY!

Thanks *舟 for donating 6 CNY! Memo: 帮了很大忙，浅表谢意

Thanks *零 for donating 15 CNY!

Thanks *杰 for donating 1 CNY!

Thanks **泳 for donating 20 CNY!

Thanks C*x for donating 50 CNY!

Thanks *洲 for donating 30 CNY! Memo: 新年好！已经决定从ob转到trilium了

Thanks *口 for donating 50 CNY! Memo: 辛苦了，多运动，注意身体

Thanks *乐 for donating 25 CNY! Memo: 一杯咖啡 at trilium

Thanks *唯 for donating 10 CNY! Memo: 大佬厉害

Thanks **玲 for donating 16 CNY!

Thanks *六 for donating 10 CNY!

Thanks *林 for donating 1.14 CNY!

Thanks *林 for donating 5.14 CNY!

Thanks *建 for donating 20 CNY! Memo: 感谢维护trilium

Thanks **行 for donating 0.5 CNY!

Thanks **建 for donating 25 CNY!

Thanks K*l for donating 2 CNY! Memo: trilium很好用，感谢大佬的付出

Thanks *欢 for donating 30 CNY! Memo: 感谢大佬

Thanks * ༼ for donating 2 CNY!

Thanks Ko-fi Supporter for donating 5 USD!

Thanks *宇 for donating 10 CNY! Memo: 瑞一杯，加油！

Thanks *婧 for donating 100 CNY! Memo: 感谢大佬的付出

Thanks **舟 for donating 66 CNY!

Thanks Roel for donating 5 USD! Memo: Thanks SO very much for reviving the Trillium Web Clipper. With ADDED options!

Thanks Ko-fi Supporter for donating 5 CNY! Memo: I love the solution, as this will open up incredible interoperability. Containers provide feature parity and in general better scalability. Thanks for pushing into a scalable future!

Thanks *夏 for donating 18.8 CNY!

Thanks *辉 for donating 36 CNY! Memo: 感谢维护trilium那么多库-新奥尔良烤乳猪

Thanks 123 for donating 5 USD!

Thanks Supporter for donating 5 USD!

Thanks *欢 for donating 30 CNY!

Thanks for the greate IDE Pycharm from Jetbrains.