trilium/README.md

84 lines
6.1 KiB
Markdown
Raw Normal View History

# Trilium Notes
2018-03-12 06:46:54 +08:00
2023-03-10 00:51:13 +08:00
[![Join the chat at https://gitter.im/trilium-notes/Lobby](https://badges.gitter.im/trilium-notes/Lobby.svg)](https://gitter.im/trilium-notes/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [English](https://github.com/zadam/trilium/blob/master/README.md) | [Chinese](https://github.com/zadam/trilium/blob/master/README-ZH_CN.md) | [Russian](https://github.com/zadam/trilium/blob/master/README.ru.md)
Trilium Notes is a hierarchical note taking application with focus on building large personal knowledge bases. See [screenshots](https://github.com/zadam/trilium/wiki/Screenshot-tour) for quick overview:
2017-12-25 11:33:36 +08:00
2023-03-10 00:51:13 +08:00
<a href="https://github.com/zadam/trilium/wiki/Screenshot-tour"><img src="https://raw.githubusercontent.com/wiki/zadam/trilium/images/screenshot.png" alt="Trilium Screenshot" width="1000"></a>
2017-12-25 11:47:06 +08:00
2022-07-11 04:21:55 +08:00
Ukraine is currently defending itself from Russian aggression, please consider [donating to Ukrainian Army or humanitarian charities](https://standforukraine.com/).
2022-02-25 03:37:12 +08:00
2023-03-10 00:51:13 +08:00
<p float="left">
<img src="https://upload.wikimedia.org/wikipedia/commons/4/49/Flag_of_Ukraine.svg" alt="drawing" width="400"/>
<img src="https://signmyrocket.com//uploads/2b2a523cd0c0e76cdbba95a89a9636b2_1676971281.jpg" alt="Trilium Notes supports Ukraine!" width="570"/>
</p>
2022-02-25 03:37:12 +08:00
2023-03-10 00:51:13 +08:00
## 🎁 Features
2017-12-25 11:47:06 +08:00
2018-11-28 02:18:24 +08:00
* Notes can be arranged into arbitrarily deep tree. Single note can be placed into multiple places in the tree (see [cloning](https://github.com/zadam/trilium/wiki/Cloning-notes))
2020-10-22 04:40:34 +08:00
* Rich WYSIWYG note editing including e.g. tables, images and [math](https://github.com/zadam/trilium/wiki/Text-notes#math-support) with markdown [autoformat](https://github.com/zadam/trilium/wiki/Text-notes#autoformat)
2018-10-13 00:38:57 +08:00
* Support for editing [notes with source code](https://github.com/zadam/trilium/wiki/Code-notes), including syntax highlighting
2018-12-19 03:50:03 +08:00
* Fast and easy [navigation between notes](https://github.com/zadam/trilium/wiki/Note-navigation), full text search and [note hoisting](https://github.com/zadam/trilium/wiki/Note-hoisting)
2018-08-30 17:56:12 +08:00
* Seamless [note versioning](https://github.com/zadam/trilium/wiki/Note-revisions)
2018-10-13 00:38:57 +08:00
* Note [attributes](https://github.com/zadam/trilium/wiki/Attributes) can be used for note organization, querying and advanced [scripting](https://github.com/zadam/trilium/wiki/Scripts)
2018-08-30 17:56:12 +08:00
* [Synchronization](https://github.com/zadam/trilium/wiki/Synchronization) with self-hosted sync server
2022-02-23 06:18:10 +08:00
* there's a [3rd party service for hosting synchronisation server](https://trilium.cc/paid-hosting)
2022-01-22 19:54:14 +08:00
* [Sharing](https://github.com/zadam/trilium/wiki/Sharing) (publishing) notes to public internet
2018-11-28 02:18:24 +08:00
* Strong [note encryption](https://github.com/zadam/trilium/wiki/Protected-notes) with per-note granularity
* Sketching diagrams with built-in Excalidraw (note type "canvas")
2019-06-13 04:10:05 +08:00
* [Relation maps](https://github.com/zadam/trilium/wiki/Relation-map) and [link maps](https://github.com/zadam/trilium/wiki/Link-map) for visualizing notes and their relations
2018-08-30 17:56:12 +08:00
* [Scripting](https://github.com/zadam/trilium/wiki/Scripts) - see [Advanced showcases](https://github.com/zadam/trilium/wiki/Advanced-showcases)
2022-01-22 19:54:14 +08:00
* [REST API](https://github.com/zadam/trilium/wiki/ETAPI) for automation
* Scales well in both usability and performance upwards of 100 000 notes
2019-01-06 05:45:18 +08:00
* Touch optimized [mobile frontend](https://github.com/zadam/trilium/wiki/Mobile-frontend) for smartphones and tablets
2018-09-01 23:50:49 +08:00
* [Night theme](https://github.com/zadam/trilium/wiki/Themes)
* [Evernote](https://github.com/zadam/trilium/wiki/Evernote-import) and [Markdown import & export](https://github.com/zadam/trilium/wiki/Markdown)
2019-07-20 20:27:36 +08:00
* [Web Clipper](https://github.com/zadam/trilium/wiki/Web-clipper) for easy saving of web content
2017-12-25 11:47:06 +08:00
2023-03-01 17:48:34 +08:00
Check out [awesome-trilium](https://github.com/Nriver/awesome-trilium) for 3rd party themes, scripts, plugins and more.
2023-03-01 17:47:27 +08:00
2023-03-10 00:51:13 +08:00
## 🏗 Builds
2017-12-25 11:47:06 +08:00
Trilium is provided as either desktop application (Linux and Windows) or web application hosted on your server (Linux). Mac OS desktop build is available, but it is [unsupported](https://github.com/zadam/trilium/wiki/FAQ#mac-os-support).
2018-09-01 17:04:31 +08:00
* If you want to use Trilium on the desktop, download binary release for your platform from [latest release](https://github.com/zadam/trilium/releases/latest), unzip the package and run ```trilium``` executable.
* If you want to install Trilium on server, follow [this page](https://github.com/zadam/trilium/wiki/Server-installation).
* Currently only recent Chrome and Firefox are supported (tested) browsers.
2017-12-25 11:47:06 +08:00
2022-08-16 00:01:55 +08:00
Trilium is also provided as a Flatpak:
[<img width="240" src="https://flathub.org/assets/badges/flathub-badge-en.png">](https://flathub.org/apps/details/com.github.zadam.trilium)
2023-03-10 00:51:13 +08:00
## 📝 Documentation
2017-12-25 11:47:06 +08:00
[See wiki for complete list of documentation pages.](https://github.com/zadam/trilium/wiki/)
You can also read [Patterns of personal knowledge base](https://github.com/zadam/trilium/wiki/Patterns-of-personal-knowledge-base) to get some inspiration on how you might use Trilium.
2023-03-10 00:51:13 +08:00
## 💻 Contribute
Use a browser based dev environment
[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/zadam/trilium)
Or clone locally and run
```
npm install
2019-10-14 17:55:12 +08:00
npm run start-server
2019-10-30 02:59:19 +08:00
```
2023-03-10 00:51:13 +08:00
## 📢 Shoutouts
2019-10-30 02:59:19 +08:00
* [CKEditor 5](https://github.com/ckeditor/ckeditor5) - best WYSIWYG editor on the market, very interactive and listening team
* [FancyTree](https://github.com/mar10/fancytree) - very feature rich tree library without real competition. Trilium Notes would not be the same without it.
* [CodeMirror](https://github.com/codemirror/CodeMirror) - code editor with support for huge amount of languages
2020-10-22 04:40:34 +08:00
* [jsPlumb](https://github.com/jsplumb/jsplumb) - visual connectivity library without competition. Used in [relation maps](https://github.com/zadam/trilium/wiki/Relation-map) and [link maps](https://github.com/zadam/trilium/wiki/Link-map)
2023-03-10 00:51:13 +08:00
## 🤝 Support
2022-02-06 00:20:41 +08:00
2023-03-26 19:33:59 +08:00
You can support Trilium using GitHub Sponsors, [PayPal](https://paypal.me/za4am) or Bitcoin (bitcoin:bc1qv3svjn40v89mnkre5vyvs2xw6y8phaltl385d2).
2022-02-06 00:20:41 +08:00
2023-03-10 00:51:13 +08:00
## 🔑 License
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.