What's Changed

• (fix): Use correct type specifications to suppress warnings by @okomestudio in #2522
• perf: suppress extra org features in the temp buffer by @dustinfarris in #2524

New Contributors

• @okomestudio made their first contribution in #2522

Full Changelog: v2.3.0...v2.3.1

What's Changed

• (perf)node-read: filter before map to candidate by @russmatney in #2168
• (chore): remove extraneous changelog line by @jethrokuan in #2172
• (fix)org-roam-file-p: don't exclude org-roam-directory by @toregilhk in #2178
• (chore) fix version numbers by @jethrokuan in #2182
• (fix) org-roam-file-p handle opening a buffer with no path by @jethrokuan in #2185
• (fix)db: update atime on file access by @jethrokuan in #2174
• Fix org-roam-extract-subtree by @ralfdoering in #2191
• (node): fix org-roam-node-at-point check by @jethrokuan in #2195
• (chore): reapply #2178 by @jethrokuan in #2197
• Solved issue #2192 (Respect blank lines in capture templates) by @alopezrivera in #2203
• (chore)ci: /s/master/main by @jethrokuan in #2204
• support custom minibuffer matching function by @cuttlefisch in #2177
• (db)fix: org-roam-db-connector group by @jethrokuan in #2209
• ensure unique candidates in org-roam-ref-find by @bdarcus in #2208
• (db)fix: FOREIGN KEY error in narrowed buffer by @psii in #2215
• (feat): org-roam-property-* code duplication removed (#2217) by @clanghans in #2218
• (db)fix: file modification detection failing in some edge cases by @kisaragi-hiu in #2221
• (fix): autoload org-roam-list-files by @jethrokuan in #2226
• (fix): links not displayed properly in org-roam-buffer by @ntharim in #2236
• (fix): remove use of deprecated org-font-lock-ensure by @jethrokuan in #2238
• was missing the FULL parameter to org-end-of-meta-data - fixes #2242 by @jmay in #2246
• (Docs): Fixed typos in the docs by @hnvy in #2256
• Fix space chars in roam refs by @hwiorn in #2285
• org-roam-tag-add: use tags separator as crm-separator by @Hugo-Heagren in #2282
• Support multi-line org titles by @FelixBrendel in #2264
• (Docs): orgmode.org/elpa has been shut down by @aviad in #2258
• Minor typo in the commented text of the definition of org-roam-refile by @apc in #2263
• fix outline of link in properties by @bhuztez in #2230
• (fix): update org-roam-unlinked-references-section check by @Elilif in #2254
• Add support for filtering backlinks. by @swflint in #2247
• (docs): update documentation on database-connectors by @jethrokuan in #2298
• (db): default to sqlite-builtin when possible by @jethrokuan in #2299
• don't complete org-roam nodes in source blocks by @ParetoOptimalDev in #2292
• (core): add org-roam-node-category by @jethrokuan in #2300
• add discoverability support for age encrypted org files by @anticomputer in #2302
• (minor): fix lints on main by @jethrokuan in #2320
• utils: descendant-of-p: Defend against nils by @qzdl in #2319
• Add customisable function for prompting when adding refs by @Hugo-Heagren in #2317
• Fix org-fold-core-style in org-roam-buffer by @hwiorn in #2325
• depend on snapshot of emacsql by @jethrokuan in #2327
• (node): org-roam-node-at-point: don't error in non-org buffers by @Hugo-Heagren in #2329
• (node) add optional NOCASE parameter to org-roam-node-from-title-or-alias by @nuthub in #2403
• (docs): update org-protocol instructions by @benthamite in #2401
• Fix some typos by @feltcat in #2430
• (docs): fix name of my-org-roam-show-backlink-p by @Delapouite in #2447
• Link Martin Edström's knowledge base by @meedstrom in #2394
• Update org-roam.org by @marcosbodio in #2441
• (chore): fix indent blocking ci lint execution by @Delapouite in #2448
• Fix Issue #2410 - Unlinked References doesnt work if the org-roam-directory has a space in it. by @vikram-mandyam in #2411
• (test): add "org-roam--list-files-search-globs" by @Delapouite in #2449
• Backlink heading by @toregilhk in #2333
• (test): add org-roam-id-find by @Delapouite in #2450
• (test): add org-roam-id-at-point by @Delapouite in #2451
• (test): add org-roam--buffer-promoteable-p by @Delapouite in #2452
• (test): add org-roam--get-titles by @Delapouite in #2453
• (test): add org-roam-node-from-{id|title-or-alias} by @Delapouite in #2454
• (test): add org-roam-alias-{add|remove} by @Delapouite in #2455
• (docs): add missing versions dates and obsolete notice by @Delapouite in #2456
• (docs): explain org-roam-file-exclude-regexp by @adamoudad in #2458
• (test): add org-roam-demote-entire-buffer by @Delapouite in #2459
• (test): add org-roam-file-p by @Delapouite in #2460
• (test): add org-roam-buffer-p by @Delapouite in #2461
• (fix): remove dead-code about org-roam-shield feature by @Delapouite in #2462
• (test): add org-roam-db--file-hash by @Delapouite in #2464
• (test): add org-roam-db-get-{scheduled|deadline}-time by @Delapouite in #2465
• Doc formatting: 2 fixes by @kevinrineer in #2475
• Take org-roam-node as argument to #'org-roam-refile by @pestctrl in #2388
• Compatibility with latest org-id version: advise org-id-find rather than overwriting id link by @ricklupton in #2432
• Depend on emacsql 4.0.0 by @bcc32 in #2466
• Use regexp match to replace hard-coded path equal test by @manphiz in #2497
• Align sqlite integration with emacsql 4.0 by @dustinfarris in #2503
• fix #2425 Prevent data loss when user has called org-roam-extract-subtree on folded org headline by @akashpal-21 in #2444
• Rely on emacsql-sqlite-open to pick the best available back-end by @tarsius in #2486
• Set org-roam-directory to a non-existent path to ensure robust test by @manphiz in #2499
• (perf): Deprecate link :outline properties by @meedstrom in #2509
• Bump DB version to avoid error by @meedstrom in #2514

New Contributors

• @russmatney made their first contribution in #2168
• @toregilhk made their first contribution in #2178
• @ralfdoering made their first contribution in #2191
• @alopezrivera made their first contribution in #2203
• @cuttlefisch made their first contribution in #2177
• @psii made their first contribution in #2215
• @clanghans made their first contribution in #2218
• @hnvy made their first contribution in #2256
• @hwiorn made their first contribution in #2285
• @Hugo-Heagren made their first contribution in #2282
• @FelixBrendel made their first contribution in #2264
• @aviad made their first contribution in #2258
• @apc made their first contribution in #2263
• @bhuztez made their first contribution in #2230
• @Elilif made their first contribution in https://github.com/org-roam/org-ro...

2.2.2

Breaking

Added

• #2138 export: add new module
• #2170 log: add new module for working with org logs
• #2158 db: support emacsql-sqlite-builtin and emacsql-sqlite-module
• #2160 core: support a list of org-roam-file-exclude-regexp

Removed

Fixed

• #2091 node: fix org-roam-promote-entire-buffer structural errors
• #2130 buffer: unlinked-references section now also searches within symlinked directories
• #2152 org-roam-preview-default-function: doesn't copy copy content of next heading node when current node's content is empty
• #2159 db: fix db syncs on narrowed buffers
• #2156 capture: templates with functions are handled correctly to avoid signaling char-or-string-p

Changed

• #2160 core: ignore files in org-attach-id-dir by default

2.2.1

Just a minor release, with no huge changes.

Breaking

• #2054 node: simplify default org-roam-node-display-template.
  This was done so completions work fine by default on all completion systems. To restore the tabular vertical completion interface, set this in your configuration:

  (setq org-roam-node-display-template
        (concat "${title:*} "
                (propertize "${tags:10}" 'face 'org-tag)))

Added

• #2042 db: add org-roam-db-extra-links-elements and org-roam-db-extra-links-exclude-keys for fine-grained control over additional link parsing
• #2049 capture: allow ID to be used as part of org-roam-capture-templates
• #2050 core: add FILTER-FN to org-roam-node-random
• #2065 dailies: add keys argument to the remaining dailies functions org-roam-dailies-goto-yesterday/-today/-tomorrow/-date and org-roam-dailies-capture-yesterday/-tomorrow/-date to give the abilty to get into a capture buffer bypassing the selection screen in all dailies commands. Extension of #2055
• #2079 capture: ensure that :ref info captured in all cases.
• #2121 buffer: add unique option to org-roam-backlinks-section

Removed

Fixed

• #2086 capture: correctly update org-id-locations on capture
• #2082 buffer: don't destroy window if org-roam-node-toggle reuses window
• #2080 dailies: prevent multiple "dailies/" subdir expansions
• #2055 dailies: removed stray f require, which was causing require and compilation errors
• #2117 capture: preserve trailing whitespace content in capture templates

Changed

• #2060 node: added double acute accent normalization for Unicode characters in titles
• #2040 completions: fix completions display-width for Helm users
• #2025 chore: removed the dependencies on f.el and s.el
• #2109 capture: org-roam-node-insert places cursor after inserted link where appropriate
• #2123, #2124 buffer: org-roam-mode-section-functions renamed to org-roam-mode-sections, supports passing args into the section-rendering function

2.2.0

Added

• #1806, #2017 db: support caching and usage of Org 9.5's in-built citations
• #1963 db: cache file title into files table
• #1977 db: support Org-ref v3 citations
• #1907, #2009, #2018 db: support sqlite3
• #2028 dailies: add keys argument to org-roam-dailies-capture-today and org-roam-dailies--capture functions to give the abilty to get into a capture buffer bypassing the selection screen

Removed

Changed

• #1795 buffer: optimized reflinks fetch
• #1809 capture: the mandatory :if-new property of each capture template is now renamed to :target
• #1829 perf: file sql updates are now wrapped in a transaction
• #1877 dailies: stop asking for time, only date
• #1949 db: check for property drawers are now case-insensitive

Fixed

• #1798 org-roam-node-at-point: do not skip invisible headings
• #1807 capture: always trigger :if-new template for existing nodes
• #1813 db: prevent empty ROAM_ALIASES from crashing db updates
• #1816 db: prevent invalid ROAM_REFS from crashing db updates
• #1893, #1896, #1901, #1895, #1904 completions: various mini-buffer related completion fixes
• #1931 utils: org-roam-set-keyword now skips over all drawers
• #1947 db: links in ROAM_REFS are no longer considered as links
• #1948 completions: fix same-line completions
• #1953 db: refresh CATEGORY before writing to db
• #1946, #1946, #1958 various performance improvements
• #1980 utils: fix org-roam-with-file changing the minor-mode
• #2016 db: fix node caching being affected by agenda variables
• #2033 db: respect local variables during db parsing

Org-roam v2.1.0

Org-roam v2.1.0 is the first release since Org-roam v2.0. It contains fixes for many issues users have faced during migration. In addition, the codebase has undergone major refactorings, making it easier to navigate and contribute to (thanks @Wetlize).

Added

• #1709 added ability to specify default value in org-roam capture templates
• #1710 added org-roam-extract-subtree
• #1720 added org-roam-db-update-on-save
• #1758 added org-roam-db-autosync-mode, replacing org-roam-setup and org-roam-teardown

Removed

• #1716 helper function org-roam-get-keyword is now obsolete: prefer org-collect-keywords

Changed

• #1595, #1724 Major refactoring and restructuring of the codebase
• #1655 improved org-roam contents preview
• #1741 expose org-roam-capture- keys in interactive commands
• #1786 org-roam-version now outputs commit hash if found
• #1788 the point is not moved if the node is already visited

Fixed

• #1608 migration: empty ROAM_REFS are now removed
• #1609 migration: fixed file-link replacement
• #1653 migration: fixed tags migration
• #1694 core: nodes with no title are now skipped
• #1637 core: fix org-ref multi-cite links not being split
• #1651 core: fix org-roam-file-p crashing when there is no corresponding file
• #1705 core: fix for add/remove of file-level tags
• #1769 core: gracefully handle absence of org-id-locations-file
• #1713 capture: check for file-existence before template insertion
• #1725 db: always compute hash of encrypted file to prevent re-processing of encrypted files

Org-roam v2.0.0

This is the first official release of Org-roam v2. Org-roam v2 is not backwards compatible with v1!

Please read the wiki for more information on the changes. For some internal insights, the author has also written a post on this release.

Org-roam v2.0.0a1

This is the first alpha release of Org-roam v2.

Why should you migrate to v2?

• only v2 is in active development
• the v2 codebase is greatly simplified and should provide a much smoother experience
• Experience the upgraded Org-roam buffer

For more information about migrating, see the wiki

Sample configuration:

(use-package org-roam
  :custom
  (org-roam-directory "/path/to/org-files/")
  :bind (("C-c n l" . org-roam-buffer-toggle)
         ("C-c n f" . org-roam-node-find))
  :config
  (org-roam-setup))

Read more about Org-roam v2 here

How do I migrate to v2?

You should be able to (for the most part) convert your v1 files to the v2 format as follows:

https://gist.github.com/jethrokuan/02f41028fb4a6f81787dc420fb99b6e4

roam: links, and roam_tags are not automatically converted.

Should you hold off on the migration?

Stick to Org-roam v1 if:

• You dislike using ID links
• You rely on external packages like org-roam-server and org-roam-bibtex
• You rely on org-roam graphing

Org-roam v1.2.4

Final release of Org-roam prior to Org-roam v2.

Mostly just small bug fixes I guess.

Org-roam v1.2.3 (13-11-2020)

Primarily a stabilization and bug-fix release.

Org-roam-dailies has also been revamped to include new features, see this video for a quick overview.

Added

• #978 Revamp org-roam-dailies
• #1183 Interactive functions for managing aliases and tags in Org-roam file, namely org-roam-alias-add, org-roam-alias-delete, org-roam-tag-add, and org-roam-tag-delete.
• #1215 Multiple ROAM_KEY keywords can now be specified in one file. This allows bibliographical entries to share the same note file.
• #1238 Add org-roam-prefer-id-links variable to select linking method
• #1239 Allow org-roam-protocol to capture the webpage's selection, and add a toggle for storing the links to the pages
• #1264 add org-roam-db-update-method to control when the cache is rebuilt.

Changed

• #1264 renamed org-roam-update-db-idle-seconds to org-roam-db-idle-idle-seconds

Fixed

• #1074 fix org-roam--extract-links to handle content boundaries.
• #1193 fix org-roam-db-build-cache by not killing temporary buffer in org-roam--extract-links.
• #1195 fix ID face showing as invalid if within Org ID files, but not Org-roam's.
• #1199 make Org-roam link insertions respect org-roam-link-title-format everywhere.
• #1201 fix org-roam-db-build-cache failing in scenarios involving duplicate IDs and deleted files.
• #1226 only update relative path of file links
• #1232 fix incorrect title extractions from narrowed buffers
• #1233 fixes bug where descriptive file links become plain links during update for relative paths
• #1252 respect original link type during automatic replacement