Set up live updates
Enable optional live updates so Zotero pushes changes to Obsidian automatically.
ZotLit Companion, the Zotero add-on, can push changes to Obsidian as you read and annotate in Zotero. The annotation view's reader-following mode and automatic database refreshes both depend on this optional connection.
When you do not need this
Basic Companion actions (opening items and their PDFs, updating notes, importing notes from the Zotero context menu) work through protocol links with no server. You only need live updates for real-time push (reader-following, instant database refresh when Zotero data changes).
Enable the ZotLit server
Open the sync settings
In Obsidian, open Settings > ZotLit > Zotero and find the 与 Zotero 同步 group. Keep 接收来自 Zotero 的更新 on.
Turn on the listener
On the 本地服务器 row, select 打开本地服务器设置. This opens the 本地服务器 group on Settings > ZotLit > 高级.
Enable 运行本地服务器. Keep the default hostname, 127.0.0.1, to accept connections from this computer only.
The configured port defaults to 9091. Check 正在使用的端口 for the port actually used: ZotLit tries a higher port if the configured one is busy.
Enable the Companion's notify preference
Open Zotero preferences
In Zotero, open Edit > Settings (Windows/Linux) or Zotero > Settings (macOS). Select the ZotLit pane.
Enable notifications
Under the Obsidian 通知 section, check 启用.
Set the Notify URL
Set the 通知 URL to point at the ZotLit server. The default value is http://localhost:9091, which matches the default port.
Use the port shown by 正在使用的端口 in Obsidian (for example, http://localhost:9092). Each vault can use a different port.
Verify the connection
After enabling both sides, open the annotation view in Obsidian and switch it to Zotero 阅读器 mode. The view starts in 活动标签页 mode and keeps the mode you last chose. Then open an item in the Zotero PDF reader. The annotation view updates to show that item's annotations. If it does not update, check that both the port and hostname match between the ZotLit server settings and the Companion's Notify URL.
Source ID filtering
The ZotLit server accepts requests only from the Zotero install whose profile and data directory match the connected source. Requests from other Zotero installs are silently ignored. The source identifier is displayed read-only as 源 ID under Settings > ZotLit > Zotero > Zotero 位置.
See also
Last updated on