How to Start Using LifeOS
Already purchased Pro? Go directly to installation and activation.
If this is your first time using LifeOS, start with Start LifeOS in 10 Minutes and practice with the example vault first. This page is better used after the example works, when you want to understand folder structure, plugin installation, and manual setup.
Directory Structure Description
It is recommended to read through the directory structure once, as it helps to deepen your understanding!
The directory below is interactive and clickable. Click the + sign to expand!
Setting Up a Repository from Scratch
Installing the LifeOS Plugin
Choose one of the following
Basic
Click here to open Obsidian and install the LifeOS plugin
Paid Version
If you purchased LifeOS Pro, follow this section. You do not need to buy or install DeepAsk. DeepAsk is an optional AI plugin with a separate license and activation code.
Back up your existing vault first. On a computer, download the stable LifeOS Pro plugin from Feishu, or use the download link in your purchase email. Extract it and copy the lifeos-pro folder containing main.js, manifest.json, and styles.css into the current vault's .obsidian/plugins/ directory. Create the folders if needed.
Alternatively, use these website backup downloads. Choose “Save Link As…” and keep the exact filenames without adding .txt:
The installed files must be directly inside:
Do not add an extra Plugin or lifeos-pro folder level, or replace your entire vault with the download. Keep personal configuration files such as data.json when updating an existing installation.
.obsidian is hidden by default. In macOS Finder, press Command + Shift + .; in Windows File Explorer, choose “View → Show → Hidden items.” If you use a custom Obsidian configuration directory, use that directory for the current vault instead.
Enable and activate LifeOS Pro
- Reload or restart Obsidian and open “Settings → Community plugins.” Allow community plugins if Restricted mode is still on, then enable LifeOS Pro. Disable the community LifeOS plugin first if it is running, to avoid duplicate functionality.
- Select LifeOS Pro in Settings and open “Activation & Upgrade.” Enter your purchase email in “Account” and paste the complete LifeOS Pro activation code from the email into “Activation Code,” without explanatory text or extra spaces.
- Wait for settings to save and verification to finish automatically. You do not need to select “Upgrade Now” to activate. Checking for or downloading updates is a separate operation. Keep your network connection available during verification.
- Confirm that the page shows “Already activated!”, then open the LifeOS Pro Home or Calendar view and check that it works without an activation error. A version number, enabled switch, or ribbon icon alone does not prove activation succeeded.
This workflow was checked against the stable 3.1.7 release artifact. If an older package has a different interface, follow the update guide to install the stable version. Do not purchase again to find a button shown in an old guide.
Activation troubleshooting
If the activation email is missing, check the purchase mailbox and spam folder. If you still need help, contact the author privately with the purchase channel, order number, purchase email, plugin version, and error message. Hide the activation code in screenshots; never post it in public groups or comments. You do not need to purchase again.
Installing Third-Party Plugins
The Dataview, Templater, and template setup below applies to the older manual structure shown above. It is not a prerequisite for activating LifeOS Pro. Follow the dependencies of your chosen vault or template.
-
Dataview: Click here to open Obsidian and install the Dataview plugin
-
Templater: Click here to open Obsidian and install the Templater plugin
Refer to the image below, enable "Trigger Templater on new file creation" in Templater

Configuring Periodic Notes
Refer to the image below, configure your periodic notes directory and the titles for each module

Refer to the image below, configure your template files for periodic notes. Each time you create a periodic note, it will use the corresponding template to create a new note

Configuring Theme Notes
Refer to the image below, configure your theme notes directory and the titles for each module

Refer to the image below, configure your template files for theme notes. Each time you create a theme note, it will use the corresponding template to create a new note

Using a Ready-Made Example Repository
Refer to: "Scenario 2"