Skip to content

Obsidian

Obsidian is a personal knowledge base and note-taking program that works with Markdown files. Users can create internal links to notes and visualize these relationships as a graph. Obsidian is designed to help the user organize and structure thoughts and knowledge in a flexible, non-linear way. Obsidian supports CommonMark and GitHub Flavored Markdown (GFM), as well as other useful features: tags, LaTeX math expressions, mermaid diagrams, footnotes, internal links, and embedding notes or external files. Obsidian has a system of plugins to expand functionality.

Installation using Flatpak

If you have the Flatpak package, you can install Obsidian with one command:

shell
flatpak install flathub md.obsidian.Obsidian

Or using the GNOME Software 🤔

Follow the link to install Obsidian, then confirm the "open application" operation in the browser. After this, the Application Center will open, select the source "Flathub" in it and click the "download" button

Installation from the Aides repository Unofficial build

If you have the stplr package, you can install Obsidian with one command:

shell
stplr in obsidian

If the Aides repository is not yet connected, add it with the following command:

sh
stplr repo add aides https://altlinux.space/aides-community/aides.git

Disclaimer

Use packages and instructions only at your own risk. Packages are built locally, so check the source code and build scripts.

Installation using epm play Unofficial build

If you have the eepm package, you can install Obsidian with one command:

shell
epm play obsidian

Running Obsidian in a Wayland windowed interface

To launch Obsidian through a terminal, specify the following launch options:

shell
flatpak run md.obsidian.Obsidian --ozone-platform-hint=auto
shell
obsidian --ozone-platform-hint=auto

Внимание

When running the Flatpak version, make sure it can run using the Wayland graphical protocol. One of the most convenient verification options is the Flatseal program

Enable Wayland graphics protocol

By default, launching in the Wayland windowed interface is prohibited. To run through it, enable the following items:

  • Wayland window system
  • Revert to X11 windowing system

An alternative environment setting is the terminal:

shell
flatpak override --user md.obsidian.Obsidian --socket=wayland --socket=fallback-x11

To run the application in the GNOME environment and ease of setup, it is recommended to install the PinApp application, select the Obsidian application, make a Pin and enter the following parameters in the Exec field:

shell
/usr/bin/flatpak run --branch=stable --arch=x86_64 --command=obsidian.sh --file-forwarding md.obsidian.Obsidian @@u %U @@ // [!code --]
/usr/bin/flatpak run --branch=stable --arch=x86_64 --command=obsidian.sh --file-forwarding md.obsidian.Obsidian --ozone-platform-hint=auto @@u %U @@ // [!code ++]
shell
obsidian %U // [!code --]
obsidian --ozone-platform-hint=auto %U // [!code ++]

Hardware acceleration:

To avoid graphical errors at startup, hardware acceleration must be disabled.

For Flatpak version you need to add a variable with the value --env=OBSIDIAN_DISABLE_GPU=1:

shell
flatpak override --user --env=OBSIDIAN_DISABLE_GPU=1 md.obsidian.Obsidian

For the epm version you need to add a variable with the value OBSIDIAN_DISABLE_GPU=1. For example, via ./bashrc:

shell
cat << _EOF_ >> ~/.bashrc
# Disable GPU for obsidian
export OBSIDIAN_DISABLE_GPU=1
_EOF_

Published under the GPL-3.0+ license. The content is available under the CC BY-SA 4.0 license, unless otherwise specified.