|
| 1 | +<div align="center"> |
| 2 | + <sup>Special thanks to:</sup><br /> |
| 3 | + <a href="https://go.warp.dev/Trilium" target="_blank"> |
| 4 | + <img alt="Warp sponsorship" width="400" src="https://github.com/warpdotdev/brand-assets/blob/main/Github/Sponsor/Warp-Github-LG-03.png"><br /> |
| 5 | + Warp, built for coding with multiple AI agents<br /> |
| 6 | + </a> |
| 7 | + <sup>Available for macOS, Linux and Windows</sup> |
| 8 | +</div> |
| 9 | + |
| 10 | +<hr /> |
| 11 | + |
| 12 | +# Trilium Notes |
| 13 | + |
| 14 | + |
| 15 | +\ |
| 16 | + |
| 17 | +\ |
| 19 | +[](https://app.relative-ci.com/projects/Di5q7dz9daNDZ9UXi0Bp) |
| 20 | +[](https://hosted.weblate.org/engage/trilium/) |
| 22 | + |
| 23 | +[English](./README.md) | [Chinese (Simplified)](./docs/README-ZH_CN.md) | |
| 24 | +[Chinese (Traditional)](./docs/README-ZH_TW.md) | [Russian](./docs/README-ru.md) |
| 25 | +| [Japanese](./docs/README-ja.md) | [Italian](./docs/README-it.md) | |
| 26 | +[Spanish](./docs/README-es.md) |
| 27 | + |
| 28 | +Trilium Notes is a free and open-source, cross-platform hierarchical note taking |
| 29 | +application with focus on building large personal knowledge bases. |
| 30 | + |
| 31 | +See [screenshots](https://triliumnext.github.io/Docs/Wiki/screenshot-tour) for |
| 32 | +quick overview: |
| 33 | + |
| 34 | +<a href="https://triliumnext.github.io/Docs/Wiki/screenshot-tour"><img src="./docs/app.png" alt="Trilium Screenshot" width="1000"></a> |
| 35 | + |
| 36 | +## ⏬ Download |
| 37 | +- [Latest release](https://github.com/TriliumNext/Trilium/releases/latest) – |
| 38 | + stable version, recommended for most users. |
| 39 | +- [Nightly build](https://github.com/TriliumNext/Trilium/releases/tag/nightly) – |
| 40 | + unstable development version, updated daily with the latest features and |
| 41 | + fixes. |
| 42 | + |
| 43 | +## 📚 Documentation |
| 44 | + |
| 45 | +**Visit our comprehensive documentation at |
| 46 | +[docs.triliumnotes.org](https://docs.triliumnotes.org/)** |
| 47 | + |
| 48 | +Our documentation is available in multiple formats: |
| 49 | +- **Online Documentation**: Browse the full documentation at |
| 50 | + [docs.triliumnotes.org](https://docs.triliumnotes.org/) |
| 51 | +- **In-App Help**: Press `F1` within Trilium to access the same documentation |
| 52 | + directly in the application |
| 53 | +- **GitHub**: Navigate through the [User |
| 54 | + Guide](./docs/User%20Guide/User%20Guide/) in this repository |
| 55 | + |
| 56 | +### Quick Links |
| 57 | +- [Getting Started Guide](https://docs.triliumnotes.org/) |
| 58 | +- [Installation |
| 59 | + Instructions](./docs/User%20Guide/User%20Guide/Installation%20&%20Setup/Server%20Installation.md) |
| 60 | +- [Docker |
| 61 | + Setup](./docs/User%20Guide/User%20Guide/Installation%20&%20Setup/Server%20Installation/1.%20Installing%20the%20server/Using%20Docker.md) |
| 62 | +- [Upgrading |
| 63 | + TriliumNext](./docs/User%20Guide/User%20Guide/Installation%20%26%20Setup/Upgrading%20TriliumNext.md) |
| 64 | +- [Basic Concepts and |
| 65 | + Features](./docs/User%20Guide/User%20Guide/Basic%20Concepts%20and%20Features/Notes.md) |
| 66 | +- [Patterns of Personal Knowledge |
| 67 | + Base](https://triliumnext.github.io/Docs/Wiki/patterns-of-personal-knowledge) |
| 68 | + |
| 69 | +## 🎁 Features |
| 70 | + |
| 71 | +* Notes can be arranged into arbitrarily deep tree. Single note can be placed |
| 72 | + into multiple places in the tree (see |
| 73 | + [cloning](https://triliumnext.github.io/Docs/Wiki/cloning-notes)) |
| 74 | +* Rich WYSIWYG note editor including e.g. tables, images and |
| 75 | + [math](https://triliumnext.github.io/Docs/Wiki/text-notes) with markdown |
| 76 | + [autoformat](https://triliumnext.github.io/Docs/Wiki/text-notes#autoformat) |
| 77 | +* Support for editing [notes with source |
| 78 | + code](https://triliumnext.github.io/Docs/Wiki/code-notes), including syntax |
| 79 | + highlighting |
| 80 | +* Fast and easy [navigation between |
| 81 | + notes](https://triliumnext.github.io/Docs/Wiki/note-navigation), full text |
| 82 | + search and [note |
| 83 | + hoisting](https://triliumnext.github.io/Docs/Wiki/note-hoisting) |
| 84 | +* Seamless [note |
| 85 | + versioning](https://triliumnext.github.io/Docs/Wiki/note-revisions) |
| 86 | +* Note [attributes](https://triliumnext.github.io/Docs/Wiki/attributes) can be |
| 87 | + used for note organization, querying and advanced |
| 88 | + [scripting](https://triliumnext.github.io/Docs/Wiki/scripts) |
| 89 | +* UI available in English, German, Spanish, French, Romanian, and Chinese |
| 90 | + (simplified and traditional) |
| 91 | +* Direct [OpenID and TOTP |
| 92 | + integration](./docs/User%20Guide/User%20Guide/Installation%20%26%20Setup/Server%20Installation/Multi-Factor%20Authentication.md) |
| 93 | + for more secure login |
| 94 | +* [Synchronization](https://triliumnext.github.io/Docs/Wiki/synchronization) |
| 95 | + with self-hosted sync server |
| 96 | + * there's a [3rd party service for hosting synchronisation |
| 97 | + server](https://trilium.cc/paid-hosting) |
| 98 | +* [Sharing](https://triliumnext.github.io/Docs/Wiki/sharing) (publishing) notes |
| 99 | + to public internet |
| 100 | +* Strong [note |
| 101 | + encryption](https://triliumnext.github.io/Docs/Wiki/protected-notes) with |
| 102 | + per-note granularity |
| 103 | +* Sketching diagrams, based on [Excalidraw](https://excalidraw.com/) (note type |
| 104 | + "canvas") |
| 105 | +* [Relation maps](https://triliumnext.github.io/Docs/Wiki/relation-map) and |
| 106 | + [link maps](https://triliumnext.github.io/Docs/Wiki/link-map) for visualizing |
| 107 | + notes and their relations |
| 108 | +* Mind maps, based on [Mind Elixir](https://docs.mind-elixir.com/) |
| 109 | +* [Geo maps](./docs/User%20Guide/User%20Guide/Note%20Types/Geo%20Map.md) with |
| 110 | + location pins and GPX tracks |
| 111 | +* [Scripting](https://triliumnext.github.io/Docs/Wiki/scripts) - see [Advanced |
| 112 | + showcases](https://triliumnext.github.io/Docs/Wiki/advanced-showcases) |
| 113 | +* [REST API](https://triliumnext.github.io/Docs/Wiki/etapi) for automation |
| 114 | +* Scales well in both usability and performance upwards of 100 000 notes |
| 115 | +* Touch optimized [mobile |
| 116 | + frontend](https://triliumnext.github.io/Docs/Wiki/mobile-frontend) for |
| 117 | + smartphones and tablets |
| 118 | +* Built-in [dark theme](https://triliumnext.github.io/Docs/Wiki/themes), support |
| 119 | + for user themes |
| 120 | +* [Evernote](https://triliumnext.github.io/Docs/Wiki/evernote-import) and |
| 121 | + [Markdown import & export](https://triliumnext.github.io/Docs/Wiki/markdown) |
| 122 | +* [Web Clipper](https://triliumnext.github.io/Docs/Wiki/web-clipper) for easy |
| 123 | + saving of web content |
| 124 | +* Customizable UI (sidebar buttons, user-defined widgets, ...) |
| 125 | +* [Metrics](./docs/User%20Guide/User%20Guide/Advanced%20Usage/Metrics.md), along |
| 126 | + with a [Grafana |
| 127 | + Dashboard](./docs/User%20Guide/User%20Guide/Advanced%20Usage/Metrics/grafana-dashboard.json) |
| 128 | + |
| 129 | +✨ Check out the following third-party resources/communities for more TriliumNext |
| 130 | +related goodies: |
| 131 | + |
| 132 | +- [awesome-trilium](https://github.com/Nriver/awesome-trilium) for 3rd party |
| 133 | + themes, scripts, plugins and more. |
| 134 | +- [TriliumRocks!](https://trilium.rocks/) for tutorials, guides, and much more. |
| 135 | + |
| 136 | +## ❓Why TriliumNext? |
| 137 | + |
| 138 | +The original Trilium developer ([Zadam](https://github.com/zadam)) has |
| 139 | +graciously given the Trilium repository to the community project which resides |
| 140 | +at https://github.com/TriliumNext |
| 141 | + |
| 142 | +### ⬆️Migrating from Zadam/Trilium? |
| 143 | + |
| 144 | +There are no special migration steps to migrate from a zadam/Trilium instance to |
| 145 | +a TriliumNext/Trilium instance. Simply [install |
| 146 | +TriliumNext/Trilium](#-installation) as usual and it will use your existing |
| 147 | +database. |
| 148 | + |
| 149 | +Versions up to and including |
| 150 | +[v0.90.4](https://github.com/TriliumNext/Trilium/releases/tag/v0.90.4) are |
| 151 | +compatible with the latest zadam/trilium version of |
| 152 | +[v0.63.7](https://github.com/zadam/trilium/releases/tag/v0.63.7). Any later |
| 153 | +versions of TriliumNext/Trilium have their sync versions incremented which |
| 154 | +prevents direct migration. |
| 155 | + |
| 156 | +## 💬 Discuss with us |
| 157 | + |
| 158 | +Feel free to join our official conversations. We would love to hear what |
| 159 | +features, suggestions, or issues you may have! |
| 160 | + |
| 161 | +- [Matrix](https://matrix.to/#/#triliumnext:matrix.org) (For synchronous |
| 162 | + discussions.) |
| 163 | + - The `General` Matrix room is also bridged to |
| 164 | + [XMPP ](xmpp:[email protected]?join) |
| 165 | +- [Github Discussions](https://github.com/TriliumNext/Trilium/discussions) (For |
| 166 | + asynchronous discussions.) |
| 167 | +- [Github Issues](https://github.com/TriliumNext/Trilium/issues) (For bug |
| 168 | + reports and feature requests.) |
| 169 | + |
| 170 | +## 🏗 Installation |
| 171 | + |
| 172 | +### Windows / MacOS |
| 173 | + |
| 174 | +Download the binary release for your platform from the [latest release |
| 175 | +page](https://github.com/TriliumNext/Trilium/releases/latest), unzip the package |
| 176 | +and run the `trilium` executable. |
| 177 | + |
| 178 | +### Linux |
| 179 | + |
| 180 | +If your distribution is listed in the table below, use your distribution's |
| 181 | +package. |
| 182 | + |
| 183 | +[](https://repology.org/project/triliumnext/versions) |
| 185 | + |
| 186 | +You may also download the binary release for your platform from the [latest |
| 187 | +release page](https://github.com/TriliumNext/Trilium/releases/latest), unzip the |
| 188 | +package and run the `trilium` executable. |
| 189 | + |
| 190 | +TriliumNext is also provided as a Flatpak, but not yet published on FlatHub. |
| 191 | + |
| 192 | +### Browser (any OS) |
| 193 | + |
| 194 | +If you use a server installation (see below), you can directly access the web |
| 195 | +interface (which is almost identical to the desktop app). |
| 196 | + |
| 197 | +Currently only the latest versions of Chrome & Firefox are supported (and |
| 198 | +tested). |
| 199 | + |
| 200 | +### Mobile |
| 201 | + |
| 202 | +To use TriliumNext on a mobile device, you can use a mobile web browser to |
| 203 | +access the mobile interface of a server installation (see below). |
| 204 | + |
| 205 | +See issue https://github.com/TriliumNext/Trilium/issues/4962 for more |
| 206 | +information on mobile app support. |
| 207 | + |
| 208 | +If you prefer a native Android app, you can use |
| 209 | +[TriliumDroid](https://apt.izzysoft.de/fdroid/index/apk/eu.fliegendewurst.triliumdroid). |
| 210 | +Report bugs and missing features at [their |
| 211 | +repository](https://github.com/FliegendeWurst/TriliumDroid). Note: It is best to |
| 212 | +disable automatic updates on your server installation (see below) when using |
| 213 | +TriliumDroid since the sync version must match between Trilium and TriliumDroid. |
| 214 | + |
| 215 | +### Server |
| 216 | + |
| 217 | +To install TriliumNext on your own server (including via Docker from |
| 218 | +[Dockerhub](https://hub.docker.com/r/triliumnext/trilium)) follow [the server |
| 219 | +installation docs](https://triliumnext.github.io/Docs/Wiki/server-installation). |
| 220 | + |
| 221 | + |
| 222 | +## 💻 Contribute |
| 223 | + |
| 224 | +### Translations |
| 225 | + |
| 226 | +If you are a native speaker, help us translate Trilium by heading over to our |
| 227 | +[Weblate page](https://hosted.weblate.org/engage/trilium/). |
| 228 | + |
| 229 | +Here's the language coverage we have so far: |
| 230 | + |
| 231 | +[](https://hosted.weblate.org/engage/trilium/) |
| 233 | + |
| 234 | +### Code |
| 235 | + |
| 236 | +Download the repository, install dependencies using `pnpm` and then run the |
| 237 | +server (available at http://localhost:8080): |
| 238 | +```shell |
| 239 | +git clone https://github.com/TriliumNext/Trilium.git |
| 240 | +cd Trilium |
| 241 | +pnpm install |
| 242 | +pnpm run server:start |
| 243 | +``` |
| 244 | + |
| 245 | +### Documentation |
| 246 | + |
| 247 | +Download the repository, install dependencies using `pnpm` and then run the |
| 248 | +environment required to edit the documentation: |
| 249 | +```shell |
| 250 | +git clone https://github.com/TriliumNext/Trilium.git |
| 251 | +cd Trilium |
| 252 | +pnpm install |
| 253 | +pnpm edit-docs:edit-docs |
| 254 | +``` |
| 255 | + |
| 256 | +### Building the Executable |
| 257 | +Download the repository, install dependencies using `pnpm` and then build the |
| 258 | +desktop app for Windows: |
| 259 | +```shell |
| 260 | +git clone https://github.com/TriliumNext/Trilium.git |
| 261 | +cd Trilium |
| 262 | +pnpm install |
| 263 | +pnpm run --filter desktop electron-forge:make --arch=x64 --platform=win32 |
| 264 | +``` |
| 265 | + |
| 266 | +For more details, see the [development |
| 267 | +docs](https://github.com/TriliumNext/Trilium/tree/main/docs/Developer%20Guide/Developer%20Guide). |
| 268 | + |
| 269 | +### Developer Documentation |
| 270 | + |
| 271 | +Please view the [documentation |
| 272 | +guide](https://github.com/TriliumNext/Trilium/blob/main/docs/Developer%20Guide/Developer%20Guide/Environment%20Setup.md) |
| 273 | +for details. If you have more questions, feel free to reach out via the links |
| 274 | +described in the "Discuss with us" section above. |
| 275 | + |
| 276 | +## 👏 Shoutouts |
| 277 | + |
| 278 | +* [zadam](https://github.com/zadam) for the original concept and implementation |
| 279 | + of the application. |
| 280 | +* [Sarah Hussein](https://github.com/Sarah-Hussein) for designing the |
| 281 | + application icon. |
| 282 | +* [nriver](https://github.com/nriver) for his work on internationalization. |
| 283 | +* [Thomas Frei](https://github.com/thfrei) for his original work on the Canvas. |
| 284 | +* [antoniotejada](https://github.com/nriver) for the original syntax highlight |
| 285 | + widget. |
| 286 | +* [Dosu](https://dosu.dev/) for providing us with the automated responses to |
| 287 | + GitHub issues and discussions. |
| 288 | +* [Tabler Icons](https://tabler.io/icons) for the system tray icons. |
| 289 | + |
| 290 | +Trilium would not be possible without the technologies behind it: |
| 291 | + |
| 292 | +* [CKEditor 5](https://github.com/ckeditor/ckeditor5) - the visual editor behind |
| 293 | + text notes. We are grateful for being offered a set of the premium features. |
| 294 | +* [CodeMirror](https://github.com/codemirror/CodeMirror) - code editor with |
| 295 | + support for huge amount of languages. |
| 296 | +* [Excalidraw](https://github.com/excalidraw/excalidraw) - the infinite |
| 297 | + whiteboard used in Canvas notes. |
| 298 | +* [Mind Elixir](https://github.com/SSShooter/mind-elixir-core) - providing the |
| 299 | + mind map functionality. |
| 300 | +* [Leaflet](https://github.com/Leaflet/Leaflet) - for rendering geographical |
| 301 | + maps. |
| 302 | +* [Tabulator](https://github.com/olifolkerd/tabulator) - for the interactive |
| 303 | + table used in collections. |
| 304 | +* [FancyTree](https://github.com/mar10/fancytree) - feature-rich tree library |
| 305 | + without real competition. |
| 306 | +* [jsPlumb](https://github.com/jsplumb/jsplumb) - visual connectivity library. |
| 307 | + Used in [relation |
| 308 | + maps](https://triliumnext.github.io/Docs/Wiki/relation-map.html) and [link |
| 309 | + maps](https://triliumnext.github.io/Docs/Wiki/note-map.html#link-map) |
| 310 | + |
| 311 | +## 🤝 Support |
| 312 | + |
| 313 | +Trilium is built and maintained with [hundreds of hours of |
| 314 | +work](https://github.com/TriliumNext/Trilium/graphs/commit-activity). Your |
| 315 | +support keeps it open-source, improves features, and covers costs such as |
| 316 | +hosting. |
| 317 | + |
| 318 | +Consider supporting the main developer |
| 319 | +([eliandoran](https://github.com/eliandoran)) of the application via: |
| 320 | + |
| 321 | +- [GitHub Sponsors](https://github.com/sponsors/eliandoran) |
| 322 | +- [PayPal](https://paypal.me/eliandoran) |
| 323 | +- [Buy Me a Coffee](https://buymeacoffee.com/eliandoran) |
| 324 | + |
| 325 | +## 🔑 License |
| 326 | + |
| 327 | +Copyright 2017-2025 zadam, Elian Doran, and other contributors |
| 328 | + |
| 329 | +This program is free software: you can redistribute it and/or modify it under |
| 330 | +the terms of the GNU Affero General Public License as published by the Free |
| 331 | +Software Foundation, either version 3 of the License, or (at your option) any |
| 332 | +later version. |
0 commit comments