gaschz/trilium
1
0
Fork 0
mirror of https://github.com/zadam/trilium.git synced 2026-02-11 08:14:39 +01:00
Code Issues Actions 13 Packages Projects Releases Wiki Activity
trilium/docs/User Guide/User Guide/Installation & Setup/Mobile Frontend.md

6.4 KiB
Vendored
Raw Blame History

Mobile Frontend

Trilium has a mobile web frontend which is optimized for touch based devices - smartphones and tablets. It is activated automatically during login process based on browser detection.

Mobile frontend is limited in features compared to the full desktop version. See below for more details on this.

Layout basics

Unlike the desktop version, the mobile version has a slightly different UI meant to better fit the constrained screens of a mobile phone.

Here is a non-exhaustive list of differences between the desktop version and the mobile one:

  • The Note Tree is displayed as a sidebar. To display the sidebar, press the button in the top-left of the screen.

    • There is also a swipe gesture that can be done from the left of the screen, but the browser's navigation gesture interferes with it most of the time (depending on the platform).
    • Press and hold a note to display the Note tree contextual menu.

  • The Quick search bar is also displayed at the top of the note tree.

  • The full Search function can be triggered either from either the Global menu or from the Launch Bar, if configured.

  • The Launch Bar is displayed at the bottom of the screen.

    • The launch bar uses a different configuration for icons than the desktop version. See the dedicated page for more information on how to configure it.

  • Most of the note-related actions are grouped in the horizontal dots icon on the top-right of the note.

  • The Tabs are grouped under a tab switcher in the Launch Bar, where the tabs are displayed in a full-screen grid with preview for easy switching, as well as additional options such as reopening closed tabs.

  • Since v0.100.0, Split View can also be used in mobile view, but with a maximum of two panes at once. The splits are displayed vertically instead of horizontally.

  • Starting with v0.102.0, the New Layout is enforced on mobile. This brings features such as the note badges, note type switcher or collection properties which would otherwise not be available.

Installing as a PWA

The mobile view can be set up as a PWA. While this does not offer any offline capabilities, it will display the application in full-screen and makes it easy to access via your mobile phone's home screen.

On iOS with Safari

  1. Open your default web browser and access your Trilium instance.
  2. Login.
  3. Press the […] button in the bottom-right of the screen and select Share.
  4. Scroll down to reveal the full list of items and choose “Add to Home Screen”.
  5. Press “Add” and the web app will be available.

On Android with Google Chrome

Important

Google Chrome requires the server to be served over HTTPS in order to display in full-screen. If using HTTP, the app will appear like a normal web page (similar to a bookmark).

  1. Open your default web browser and access your Trilium instance.
  2. Login.
  3. Press the three vertical dots icon in the top-right of the screen and select Add to Home screen.
  4. Select the Install option.
  5. Select an appropriate name.
  6. The web app will appear as an application, not on the home screen.

On Android with Brave

Important

Brave requires the server to be served over HTTPS in order to display in full-screen. If using HTTP, the app will appear like a normal web page (similar to a bookmark).

  1. Open your default web browser and access your Trilium instance.
  2. Login.
  3. Press the three vertical dots icon in the bottom-right of the screen and select Add to Home screen.
  4. Press the Install option.
  5. The web app will appear as an application, not on the home screen.

On Samsung Browser

  1. Open your default web browser and access your Trilium instance.
  2. Login.
  3. Press the hamburger menu in the bottom-right of the screen.
  4. Select Add to, followed by Home screen.
  5. Press Add and the web app will appear on the home page.

Testing via the desktop application

If you are running Trilium without a dedicated server installation, you can still test the mobile application using the desktop application. For more information, see Using the desktop application as a server. To access it go to http://<ip>:37840/login?mobile .

Forcing mobile/desktop frontend

Trilium decides automatically whether to use mobile or desktop front-end. If this is not appropriate, you can use ?mobile or ?desktop query param on login page (Note: you might need to log out).

Alternatively, simply select Switch to Mobile/Desktop Version in the Global menu.

Scripting

You can alter the behavior with Scripting, just like for normal frontend. For script notes to be executed, they need to have labeled #run=mobileStartup.

Custom Launch Bar widgets are also supported.