The Archive: Release Notes
v1.2.6 Beta (2019-05-17)
I changed some triggers and responses to external events, so please give this release a thorough beating!
- Fixed: Error dialog popping up when you externally delete the currently displayed note.
- Fixed: Errors when renaming notes you deleted externally.
- Changed: Renaming a note in your search result list that was actually removed from disk will restore the contents to the new location instead of showing an error dialog.
- New: On first launch, installs a Saved Search called “The Archive”, searching for the demo notes via
#thearchiveto demo this feature. If you have the app installed already and see this in your update notices dialog, fear not, you won’t be affected!
v1.2.5 Beta (2019-05-07)
- Fixed: Launch bug from v1.2.4 Beta 1.
v1.2.4 Beta (2019-05-04)
- Fixed: Graphics glitches on macOS 10.13.x in the Theme Updater window during the fade animations.
- Fixed: Renaming notes externally now updates the note result list again; the regression was introduced in v1.2.2b.
- New: Save and restore the scroll position for each note. When you enable “Highlight search terms”, the editor will still scroll to show the first match. This does get rid of weird situations like scrolling down in a long note, then selecting a short one, and ending up way down at the bottom of it, too.
v1.2.3 Beta (2019-04-20)
- Fixed: Clear search button in the Omnibar was obstructed and didn’t work and sometimes didn’t even display.
- Fixed: Dark theme setting is stored properly and doesn’t fall back to “Tomorrow”.
- Fixed: Trying to delete a note twice when you cancel the first confirmation request: I introduced a bug where the second try wasn’t recognized as a new deletion attempt and got ignored completely.
- Fixed: In the Saved Searches editor, the color of the search terms was black on blue and is now properly highlighted.
- New: Global bring-to-front hotkey to search quickly from anywhere while the app is running.
v1.2.2 Beta (2019-03-30)
- Fixed: Regression introduced in v1.2.1 where the search results wouldn’t update when you triggered a similar search multiple times (e.g. clicked on tags) or invoked Saved Searches.
- Changed: Improved performance. In some cases, updates to the search result list happen faster now.
- New: Touch Bar buttons for the navigation controls.
v1.2.1 Beta (2019-03-24)
- Fixed: Navigating backwards into the past a lot resulted in forgetting how to get back to the future.
- Fixed: Error dialog when navigating back to a note that was deleted. Deleting a note that was selected according to your history records now results in the history entry being removed.
- Fixed: Similarly, no errors after renaming a note that was part of history anymore. Renaming a note results in rewriting affected history items. Oceania had always been at war with Eastasia.
- New: You can navigate back from a search that yields no results, and then forward again. (Previously, only displaying a note would be added to the navigation history, so if you typed without changing the displayed note, as far as the app was concerned, you still were at the last item in the history.)
v1.2.0 Beta (2019-03-14)
- New: Back/forward navigation!
- The Archive now sports a history of displayed notes: you can navigate back and forward to get to previously displayed notes and back again.
- Since the convention for indenting/outdenting text is Cmd+]/Cmd+[ respectively, and since Ctrl + arrow keys is used to jump around in text, the shortcut for navigation is Cmd-Ctrl + arrow keys like in some web browsers and e.g. Xcode.
- You can Show/Hide the new Navigation Buttons (from the “View” menu).
- New: Inter-app-identification like it’s the 80s: Added
ZkTAas the shorthand app identifier. You probably cannot do much with it directly, but some 3rd party apps like spell-checkers may rely on this to perform their … checking … of spells.
- Fixed: Temporary memory leak when switching archives.
- Fixed: Sort order when copying notes is maintained. Also, it’s faster.
- Changed: When your drive’s Finder Trash is broken or doesn’t exist, the app then tries to removes instead of trash the file.
- Changed: Improves the undo/redo cycles of note creation and deletion so you don’t get as many failure dialogs, e.g. when you sync your archive via Dropbox.
- Changed: Cleaned up and simplified a lot of the behind-the-scenes handling of most of what the app does. Speed increase is negligible, sadly :)
- Fixed: “What’s New” launch dialog is now Mojave dark-mode ready, and doesn’t appear on first launch anymore, but only after you update.
- Fixed: A couple of small memory leaks when you switch archives.
- Changed: Improved the overall performance of the app by making the main event pipeline faster.
- Changed: Selecting multiple notes empties the Omnibar. Previously, the title of one of the selected notes was still displayed in there, not corresponding to the fact you don’t see an editor.
- New: The Omnibar displays a placeholder text of a light shade.
- Fixed: Broken display of some preferences on High Sierra due to an Apple Bug that wasn’t fixed back then, it seems.
- Fixed: The new sidebar settings didn’t adjust to large Saved Search icons.
- Fixed: Preferences window sizing and animation did wobble in the past.
- New: When you pick a font that is not at regular width or does not support bold, italic, or bold-italic, you are warned about the font’s missing features.
- Fixed: Crash when using the “Capture Image” function with the new security settings since Mojave.
- Fixed: Collapsing sidebars or making the app full-screen does not break text editor layout anymore.
- Fixed: The text field of renaming a note used black text on white background in dark mode. This is now reversed to fit the system standard.
- Fixed: Allowing/disallowing themes to change fonts takes effect immediately now.
- Fixed: Various dark mode-related fixes, like translucent icons, non-adaptive buttons, and introducing nicer colors.
- Fixed: Changing colors or otherwise editing Saved Searches did progressively darken all custom tint colors until they turned black. (This was a fun bug, because it showed how saving colors in SRGB and restoring in a different color profile could slowly deteriorate overall color appearances.)
- New: Dark Mode theme switches. Theme settings now also have a separate preference pane.
- Fixed: Crash when changing Saved Search and Quick Entry shortcuts.
- Fixed: Mojave cutting-off preferences at the bottom.
- New: “Copy Link to Note” added to the Edit menu.
- Fixed: Bug where editing note A and then selecting note B would overwrite the contents of B with A.
- Changed: Enabled Mojave App Notarization. Should now perform the first run even easier on Mojave.
- New: Support for macOS 10.14 Mojave and its Dark Mode!
New since Version 1.0.1:
- External changes to files in the archive are picked up and displayed live in the editor.
- Themes now also provide color settings for the sidebar.
- Themes can be updated from within the app.
- More intuitive behavior when browsing notes, not scrolling around when switching notes as much as before.
- Various small fixes and behavior tweaks, like: link highlight fixes; changes to the behavior of highlighted terms; more whitespace in the user interface.
A breakdown of changes since the last release:
- Fixed: Creating a new note with Cmd-N before pending changes to the currently displayed note have been saved would not select and display the new note.
- Fixed: Wiki links with
[[...]]do not span multiple lines anymore.
- Fixed: Changing Saved Search icon tint didn’t work unless you changed the radio button selection.
- New: Display the sole note automatically when your search produces only 1 result. This is intended to treat e.g. pasting note titles into the Omnibar as an “Open” command.
- Fixed: Saved Search icon changes show up in the sidebar immediately now.
- Changed: Do not jump to search terms for the best match but keep the cursor at the last insertion point: this way you can jump between notes using the search and continue where you left off.
- Fixed: Searching in the Omnibar that produces a “match” (i.e. selects a note starting with the search string) would move focus to the editor after the 2nd character. Now you can search for more than 2 characters again.
- Fixed: React properly to external file changes according to the Basil 2x2 Matrix.
- Fixed: Broken undo introduced in v1.0.8.
- Fixed: Display flickering introduced in v1.0.8.
- Fixed: The big one: external changes are now getting through to the editor.
- Fixed: Remove line breaks when pasting into the Omnibar.
- New: Preview the theme’s background color in the Saved Search icon editor so you can configure the colors more accurately.
- New: “What’s New” info window on launch after significant updates (like this one).
- Fixed: Updating themes did not work, now it does. Please update your themes, too!
- Fixed: When all you did after an autosave was to undo an indentation change, this wasn’t considered to be needed to be saved and thus the change was lost.
- Changed: Increased padding around icons in the Saved Searches sidebar.
- Changed: Increased search result vertical whitespace.
- Changed: Broken themes will now produce an error message that can help theme developers debug their stuff.
- New: The format menu sports a “Quote” submenu with shortcuts to increase and decrease the quotation level.
- New: Themable sidebars and search result lists. Existing themes have been updated accordingly.
- New: Themes now offer a tasteful default Saved Search icon color so that you don’t have to worry about finding a nice-looking color again when you switch themes.
- Fixed: Avoid re-displaying the same note text, potentially reducing editor flickering during auto-saves.
- Fixed: Emails are now made clickable differently, which makes
message:links to Mail.app’s messages behave properly.
- Fixed: Formatting command shortcuts activate autosaving, too. (Previously, only typing did.)
- Fixed: Tab-indented lists are now styled correctly, including highlight of links in indented list items.
- Fixed: Markdown images on the same line as a reference-style link did highlight everything in between as part of the image markup.
- Fix: Display new themes when available.
- Fixed: External file changes were consumed properly, but also triggered by internal changes to a note. In some cases, this made the cursor move back to the old position.
- Fixed: External file changes now affect the currently displayed note, too. This should prevent data loss when you switch between The Archive and an external editor quickly and often. This should also get rid of error dialogs about conflicts when you rename, move, or delete the currently displayed note from the Finder.
- Fixed: On High Sierra, opening the help menu prevents the app from accepting any further input if you don’t close it by hovering over another main menu item. (I suspect this is because the “Search” box in the help menu doesn’t give back focus to the window. See rdar://39374865) You can see the bug in action when you focus the Omnibar so it gets the blue focus outline, then click on the the Help menu item. The blue outline should vanish. Now hover over the Window main menu. The outline should come back. That’s when the window reacquires focus. That still doesn’t happen when you just click out of the Help menu, but at least it’s not blocking input anymore, either.
- Changed: Improve performance of complex term highlights.
- Changed: All built-in themes now support colored search term highlighting.
- New: Disable alternating result list background colors from the settings.
- New: An all-new theme updater that manages, well, theme updates.
- Fixed: Selecting “Help > Registration” did show the right preference pane, but did not select the right toolbar item.
- Changed: Hashtag recognition supports a few more special characters.
- New: Boolean search expressions:
#emotion !#hate, or the more verbose
#emotion AND NOT #hate(case-sensitive!). The available operators are
AND(or just space),
NOT(or prefixed with a
!), and parentheses, like:
(#note OR #zettel) writing !publish.
- New: Phrase search!
"the archive" OR #zettelkastenwill match, as expected,
the archivebut not
- Fixed: The “Nothing Selected” editor placeholder now does not show a scroll bar when Typewriter Mode is enabled.
- Fixed: Setting a title in the Quick Entry window was ignored when you generate a Zettel ID.
- Fixed: Saved Search icon tint usage was not properly bound to the “Tint icon” checkbox state, allowing color changes when the checkbox was unticked.
- Fixed: The first change of a Saved Search icon with the “Tint Icon” checkbox unticked was ignored in the preview box.
- Changed: Ctrl-A and Ctrl-E will jump to the beginning and end of the Omnibar’s text, respectively. Alt-Up/Alt-Down will do, too, now not remote-controlling the table anymore.
- Changed: Make the “Add Saved Search” button more prominent.
- New: Cmd-S saves Quick Entry note drafts, too.
- Fixed: Using letter-based shortcuts for saved searches.
- Fixed: Quick Entry helper’s shortcut assignment did not always store the key combo.
- Fixed: Prevent the Saved Searches editor window from entering fullscreen mode.
- Changed: Removed the hideous light drop shadow of icons in the Saved Search sidebar.
- New: Toggle-able Saved Search sidebar size (large & small).
- New: More default Saved Search icons.
- Fixed: Switching themes did carry over editor colors if they are not set by the new theme, resulting in a weird mix of colors until you restart the app.
- Fixed: Renaming a note while the sidebar is hidden will show the sidebar first.
- Fixed: Show/Hide sidebar menu items did not update their text when the editor was focused, only from the Omnibar.
- Changed: Renamed the sort options from “descending” and “ascending” to something meaningful. I can never remember which is which, and I coded this myself. This is not a vocabulary test, it’s a productivity-enhancing app, so out with the bourgeois terminology!
- Changed: Renamed “Search Results” to “Note List”.
- Changed: Picking an external editor will show the
/Applicationsdirectory by default.
- New: “Insert Zettel ID” (wired to Cmd-U) from the “Edit” menu will, well, insert a date-based Zettel ID. Totally not configurable at the moment.
- New: Setting to call new files “Untitled” as before, or use a Zettel ID that is still free to speed up verzettelling :)
- New: You can now close the main app window.
- Fixed: The launch window now updates the previously known directory live instead of only after relaunch.
- Fixed: Crash on macOS 10.11 when showing the App Guide.
- Fixed: External
/match/URL invocation did not retain the supposed selection.
- Changed: Use segmented controls in the preferences. As the saying goes, a word says more than the same word with a stupid icon, or something.
- Changed: New demo notes.
- Changed: The directory selection window now can quickly open the last used location.
- New: 60-day trial instead of expiring beta. It is getting serious.
- New: Create and open an archive in
~/Documents/Notes (The Archive)upon launch. No more boring “pick a directory” window unless you want to see it. Aaaand you probably have to, because as I mentioned above, launching this version will change your active archive directory once. :)
With this update, all you helpful beta testers are now immortalized in the “About” window’s text. Thank you very much for helping us make the app better!
- Fixed: A few regressions introduced in v0.5.1: there was a speed bump when ⌘A selecting lots of notes; and renaming the note didn’t reflect the name change in the Omnibar.
- Fixed: Starting to rename a note now scrolls the list until its row is visible so you know what and where you are typing.
- Changed: Tabbing and back-tabbing during and after editing a note title. Should now be a bit smoother.
- Fixed: Tackles the crash that a lot more people have experienced since my last attempt at fixing it :)
- Fixed: Renaming a note with an active search did deselect it in the results.
- Fixed: Tweaked a bit of code to maybe prevent a rare crash that nobody but Sascha ever triggered so far.
- Fixed: Actions from the “Note” menu that depend on a selection in the results list are now disabled when you are editing a note that is not part of the results list anymore, for example after changing the search.
- Fixed: When creating a note from the Omnibar, the editor did scroll down to keep the first line of text at the top, ignoring the top editor insets.
- Fixed: Forgot to insert a “points” unit label in the “Editing” preferences after the search result size.
Heads up! When you update, your old filters will be gone. Please take note of your settings before updating and refer to the forum for info about the migration.
- Fix: When the Saved Searches editor is open but in the background, “Edit Saved Searches” now brings it back to front properly.
- Fix: Closing the find bar gives focus back to the note editor.
- Changed: Revamped the launch window a bit.
- New: Added “Create Demo Archive” to the launch window (access it by using “Switch Archives…” from the app menu).
- New: Added “Create Demo Notes…” to add the demo notes into your current archive if you happen to need an interactive guide.
- New: Added “Explain Interface” help menu item to, well, explain the user interface for less tech-savvy newcomers.
- New: You can assign custom shortcuts to saved searches.
- New: You can drag to reorder saved searches in the dedicated editor window.
If you want to propose changes to the demo notes, check out the forums and our public GitHub repository: https://github.com/Zettelkasten-Method/The-Archive-Demo-Notes
Finally, after 3 months of relative silence, The Archive spawned new open source libraries! I published the UI explanation overlays as
AppGuideOverlay And to animate the cutouts, I created
LoopingAnimation. This produces a total of 8 published libraries for this app so far, which makes me really happy.
- Fix: The reset-button for external editors does not appear when the external editor was already reset to “System Default”.
- Fix: Clicking
[[WikiLinks]]did not select the best match for you in the list. Again.
- Fix: Clicking
#hashtagsresulted in lost focus, impeding keyboard control; now the Omnibar has focus so you can continue to keyboard-control the app.
- Changed: Remove print-related, non-functional menu items.
- Changed: Undo renaming note is now deactivated. This caused trouble in the past when the file system couldn’t catch up undoing/redoing very quickly. Also, when do you rename a note and want to undo the change instead of correcting a mistake in practice?
- New: Custom icons for the preferences tabs.
- Fix: Issue when holding down the arrow keys for a while to move around in the results list. The note you select next wouldn’t display.
- Fix: Text drawing issue when pushing the last line of text down by adding empty lines above it. (
- Fix: Lost focus after renaming a note; this prevented ⌘R to work repeatedly.
- Fix: Tabbing around works more reliably, especially tabbing out of the note renaming text field back into the editor.
- Fix: Editing note A and clicking on note B did discard the click due to note A being saved. Now the desired selected note change works.
- Fix: Bug by Apple where deleting in the 2nd line of text drew the insertion point too far up. (
- Changed: Removed “Save…” from “Note” menu.
- New: Deleting a note from the list select an adjacent note automatically, preferring the one below, as long as the deletion was triggered for the currently selected note. It does not change selection when you right-click someplace else in the list.
- Fixed: Searching for a single Emoji and then selecting a note displayed the note title in monospace inside the Omnibar.
- Fixed: “Rename” from the contextual menu works again.
- Fixed: Composable accent characters now do not replace selected text but surround it with their pairs, so that you can mark text as code or wrap in single quotation marks even though you use these keys to write
- Fixed: Editing file extensions did not update the list of extensions to select the default extension from when you just clicked on the drop-down.
- Changed: Search for non-ASCII letters/characters should be resilient against encoding problems.
- Changed: Identical searches are not ignored anymore, so you can use a Saved Search shortcut multiple times in a row, e.g. to reload the results.
- Fixed: Matching URLs was improved to exclude closing parens and other non-usual characters at the end of a web link.
- Fixed: You can now use backticks (`) and quotation marks (
') to compose accented characters in keyboard layouts that support this, e.g. U.S. International - PC or various European language ones. To get the auto-completion of character pairs in spite of the macOS accentuation mode, simply type space to type the character itself and trigger auto-pairing.
- Changed: Blockquote highlighter is more relaxed now to highlight empty lines with a
>in a row, too.
- Changed: Clicking the same
[[WikiLink]]will now refresh the search results (removing notes that no linker match the link contents) and take you to the best match again. In other words, clicking the same link more than once behave the same now, whereas it used to ignore consecutive clicks.
- Changed: Typing keys that are used to compose accented characters (usually drawn as the accent with a yellow background, waiting for completion) now does not trigger auto-pairing unless you abort the composition (with ESC or space, for example).
- Changed: Line width computation is now based on EN-width instead of EM-width (making it narrower for proportional width fonts). This is supposed to improve compatibility with iA Writer Duospace Font.
- Fixed: Formatting shortcuts are functional again.
- Fixed: Selecting lots of notes is now way faster – almost instantaneous, in fact. Even with 45k notes.
- Fixed: Crash when indenting a line with a single character in it using ⌘].
- Changed: Dragging in the result list expands note selection instead of changing it.
- New: Multiple note selections in the results list (as usual, use command-click to pick some, or shift-click to select a range).
- New: Copy Link/Copy Links in result list’s contextual menu.
- Fixed: Indent/outdent selection works more reliably with mixed indentation characters (tabs and spaced).
- New: Configurable soft tabs (2 or 4 characters wide).
- New: Bold/italics shortcuts behave more clever: when the selected text is already emphasized, they try to de-emphasize the text. It you have no text selected, the shortcuts behave as if you type the
_yourself, making them overwritable. Also, hitting the shortcut a second time inside the emphasis closes it instead of opening a new emphasis pair.
- Fixed: Another case where the blinking cursor was drawn too far to the top.
- Fixed: Do not ask for quitting confirmation when installing an update.
- Fixed: ESC inside the Omnibar properly deselects the note in the results list.
- Fixed: Reporting errors via email with ampersands
&in error file names did truncate the message.
- New: Show warning when the selected theme file is broken.
- Fixed: Insertion point is not drawn too far to the top anymore when you insert line breaks at the end of a note.
- Changed: Log files do now rotate daily (I don’t know if there’s a pun intended by the folks who came up with the terms). This means the app will keep 5 daily log files and clean up the rest. No more ever-growing multi-megabyte logs anymore, hooray!
- New: Help ▶ Send Log Files, in case you need to send your log files for debugging.
Please delete existing themes to have The Archive save new versions on launch.
- Fixed: Removed vertical resizing indicator (mouse cursor) at the bottom edge of the
- Fixed: Typewriter mode didn’t “lock” on to the correct position for a while, which now seems to not cause problems anymore.
- Fixed: The currently selected match of highlighted search terms in the text editor did not look much different from all the others, making it hard to see where your selection is.
- Fixed: Clicking a
[[WikiLink]]did not allow selecting the note from which you came right away. When the search produces only the link source itself, you weren’t able to do anything with the search results.
- Changed: Switching fonts from a monospace to a flexible width font now shows an alert. If you switch from one flexible width font to another, you won’t be nagged, though. (So you can adjust font sizes without problems, for example.)
- New: Safe-guarding dialog that asks before you quit in case you accidentally hit ⌘Q, for example when you tab between applications.
- Fixed: Emphasis flanking and flanked by parens and punctuation marks works correctly.
- Fixed: Emphasis of single characters.
- Changed: Markdown emphasis is now less strict: text will stay bold and italicized with a space character before the closing asterisks, so that emphasis remains visible while you type inside.
- New: Highlight MultiMarkdown-style footnote syntax, like
[^this-here]for a reference footnote, and
[^The footnote text directly]for Pandoc/MMD4 inline footnotes. Comes with a new theme rule, surprisingly called
- New: Themes now support an optional
highlight, but there it has no effect, yet) in order to customize the color of highlighted text when the window is not in the foreground or the text editor does not have focus. Previously, macOS used its default gray.
- Fixed: Highlights headings and code blocks at the end of the document, even without trailing new lines.
- Changed: Double-clicking the font preview in the editor settings opens the font picker.
- Changed: Double-clicking an icon in the Saved Searches editor opens the icon picker popover.
- New: Picking a non-monospace font will show a notice in the settings.
- New: Added “Allows theme to override font” setting, which is enabled by default; disabling it will make multi-font themes uniform, retaining all color and the font replacement’s style settings (bold, italic).
- Changed: Experimental Markdown highlighter fix. Could also be more broken. Looks good to me so far, though.
- Fixed: Files in subfolders are ignored and are not added to the index anymore.
- New: The find bar of the editor is closed when you switch notes.
- New: You can invoke “Find and Replace” for the editor from within the Omnibar and the results list. From anywhere, actually.
- Fixed: Crash when changing font/font sizes a lot, then switch notes or type.
- Fixed: Unpredictable surprise crash when switching notes or type.
All of these weird crashes are not a good sign for the new Markdown highlighter, I have to admit.
- Fixed: The font color of search term highlights did not disappear when you began editing a note, but now they do.
- Fixed: Carriage-returns instead of proper newlines now do not interfere with highlighting anymore. (Unlike advertised, this did not ship with v0.4.10.)
- Changed: Scroll results to top when typing in the Omnibar. (I did wonder why there are so little results after a search for old stuff more than once because I did not realize I could scroll up to reveal more. I have no clue where this assumption came from, but here it is, and it feels better now that it works accordingly.)
- Fixed: Crash when browsing through long notes rapidly with search term highlighting enabled. As a side effect, highlighting performance should now be a bit better, too.
- Fixed: Showing properly sized icon in the “Loading” window.
- Fixed: The “Loading” window now hides when you tab into another app and does not obstruct other applications.
- Fixed: Crash when working with blockquotes.
- Fixed: A few new layout glitches.
- Fixed: Fix Markdown issues with mixed newline characters, noticeable around headings, for example: Treat newline characters from Windows (carriage return) as lines terminators properly.
- Fixed: When sorting by modification date, selecting a note with the mouse did not work (because the re-sorting interfered); now it does!
- Changed: Improve performance of the Markdown highlighting slightly.
- Changed: Dragging around in the results list changes the active note; this is an unintended but welcome side effect of mentioned fix for selecting notes before re-sorting the result list.
- Fixed: Text layout problem, resulting in crashes and overlapping characters.
- Fixed: Changing the archive directory does not reset the sort order to “Title Ascending” anymore.
- Fixed: Changing the sort order with an active search now properly re-sorts the currently visible results.
- Changed: Atx-style headings are recognized without empty lines around them.
- Changed: Blockquotes do not require an empty space character after the
- New: Sorting by modification date – find the settings in the View ▶ Sort By menu!
- New: Added “Reload Results” (⌃R) to the Search menu for now to perform the same search again to update results.
- New: “Disable Markdown” made its return to the Debug menu.
- Fixed: Reference-style link matching is not greedy anymore, that is not everything between a first and second link in the same paragraph will become blue.
I bit the bullet and wrote a lightweight Markdown syntax highlighter completely from scratch. That’s not to brag, but it’s important to know that a lot might look differently now:
- Fixed: When switching active notes where one started with a link and the other didn’t falsely styled the other one as a link, i.e. blue with underline.
- Changed: The syntax highlighter is different, so some files may produce different output than before.
- New: The Theme files have changed completely.
- Fixed: Typing 2 asterisks or underscores after a word now does not produce 3 anymore (the 2nd one was treated as an auto-completable new pair).
- Changed: Typing 2+ asterisks or underscores results in auto-completing the same amount of characters after the caret. Previously, typing
**was interpreted as closing an emphasis; now it is treated as opening another bracketed asterisk pair. This is weird to put into words, but you’ll see as soon as you type 2 asterisks. Try it!
- Changed: Allow even more special characters like
- Fixed: Auto-continuation of ordered lists wrapped to “1” after “10”, but now correctly continues with “11”.
- Fixed: “Copy title” from the contextual menu did not copy the title of the note you clicked on, but the currently visible note.
- Fixed: Many shortcuts and menu items related to the results list were disabled.
The mega-update I planned to release today will take some more time, sorry!
- Fixed: Typing a quotation mark either before or (new!) right after a word does not insert a second one after the caret. Same for
- Fixed: Hitting Tab in the Quick Entry text field now switches focus to the title instead of indenting the line.
- Fixed: ⌥+Tab shortcuts and all formatting shortcuts now work in the Quick Entry text field.
- Fixed: “Toggle List” formatting did not recognize ordered list items with parens, like
- Changed: When using “Select Line” (⇧⌘L) in a list once, it selects textual list contents excluding the list item; use the shortcut again to select the whole line.
- New: Brand new Saved Search editor so you can edit your saved searches from the menu bar and hide the sidebar if you want.
- New: You can disable search highlighting in the note editor with a new setting. Disabling will not highlight search term occurrences visually and will not scroll down until the first match is visible.
- New: Continuation of blockquote markers now works just like list markers: hit Enter in a blockquote environment and the new line will start with a
- Fixed: Hard-to-explain issue of outdated search results. Say you searched for the ID
201709300742through clicking on a link. Then you got 2 results, one with the link, one of the note itself. Then you renamed the note’s title, keeping the ID, and clicked the same link again – poof, note was gone. That’s because clicking a link cleared the “old known notes” cache; but since the search term was the same, it did not perform the search request.
- Fixed: Once you edited a note in your current workspace (= your search results), switching back to the note later will put the text editing caret where you left it off instead to the first search term match.
- Fixed: Typing in the Omnibar did not live-update the search highlight inside the note, if any, until you switched to the editor view.
- Fixed: The error reporting dialog now includes the correct build number.
- Fixed: After launch, the notes are in the expected sort order from last time instead of resetting to “Title Ascending”.
- Changed: Renamed “Filters” to “Saved Searches” for now. Real filters will be different, more like in v0.1, where you could activate a filter and search inside the confines of its context.
- Changed: Adding emphasis using ⌘I or ⌘B now puts the caret in between the marks when you don’t have anything selected.
- Changed: Removed
$to denote math markup because the Markdown extension was matching text too eagerly.
- Changed: Invoking a search using a saved search now auto-selects a matching note by the same rules a manual search would, so you can write index notes for your saved searches.
- New: Naive-ish continuation of list environments when you hit the newline. Will also continue inside code blocks, which is not ideal, but we’ll get there.
- Fixed: Removing a note from the file system that’s part of the search results now displays a cached version of the note before it was deleted. You can edit it and never know somebody removed the file from your archive directory. This is another measure to ensure reliable search results consistency.
The motto of the 0.4 version branch is reliability. We’re approaching a first stable public release, folks.
- Fixed: Delete note, undo, redo, then undo again – this used to report an error because the re-creation was attempted twice.
- Fixed: Remembering and scrolling to the old caret position got in the way when you did not tab but clicked into the editor. When you click, your caret now lands below the mouse cursor again.
New: Search results are treated as your temporary contents “on the desk”, being exempt from (most) file system changes:
- Creating a new note with ⌘N while a search is active displays the new note even though it doesn’t match the search criteria.
- Removing the search term contents from a note does not remove it from the search results immediately anymore.
- Fixed: When searching in a note and then typing, the cursor sometimes used to jump back to the first occurrence of the search term while you typed.
- New: Remember text selection/cursor position in notes.
For this release, I created an open source library to store the text selection in file metadata, called
SwiftXAttrs. All in all, I thus published 6 libraries so far during development.
I replaced the way notes are stored internally. Previously, your files on disk were the dominant source of information; now it’s the content in main memory. This has a ton of consequences, like sped-up response times when creating and editing notes – because while changes are still stored to disk, the changes appear in memory first, and they do appear fast.
Should fix, among other things:
- file conflicts when renaming
- note creation errors when hitting “Enter” twice too quickly
- Fixed: Full-screen mode toggling did not adjust the lowest possible caret position in typewriter mode.
- Fixed: Reading files with broken encoding falls back to something instead of skipping the note.
- Changed: Improved performance of the Markdown highlighting when changing notes rapidly.
- Changed: Support
- Fixed: Undoing surrounding text with Markdown emphasis markup produced the wrong “original” text when it was itself a bracket or syntax element.
- Fixed: List items on multiple lines are now indented correctly for non-monospaced fonts.
- Fixed: Changing the main window to fullscreen mode and back again sometimes made the centered text column too small.
- Fixed: Searching inside the note (⌘F) previously broke the behavior of tabbing from the Omnibar to the editor.
- Fixed: First launch (or launch after deleting themes) does not show a white text editor anymore.
- Fixed: A cause of erratic scrolling when the displayed note text changed, maybe even on auto-save events.
- Changed: Picking a new filter icon now sports a regular and easy-to-notice button instead of the clever triangle.
- New: When navigating search results, Cmd and Alt plus the arrow keys lets you quickly jump to the beginning or end of the list.
- New: Search terms are highlighted within the note and the text scrolls down to make them visible.
Focus on list and block editing:
- Fixed: If you had disabled Markdown highlighting, it would ignore the setting at next launch.
- Fixed: Deleting the opening parens of an auto-completed parens pair does not remove the first character after the parens anymore.
- Changed: Emboldening and italicizing selected text with the menu shortcuts now selects the resulting emphasized text instead of putting the caret at the end.
- Changed: Solarized theme’s caret colors. (You have to delete existing files to have them copied over on launch.)
- New: “Select Line” in the Edit menu.
- New: “Find” shortcut (Cmd-F) works with focus in the Omnibar and the results list to search inside a note.
- New: Make any text into a list with the new “Switch List Type” (Cmd-T) format option! Note: Suggestions for a better term than “switch” are very welcome. I cannot recall which English verb expresses going in circles between the options here the best. For 2, it’d be “toggle”, but for 3…?
- New: You can indent and outdent lines of text by selecting text and hitting tab (or use Cmd-] and Cmd-[, popular for English keyboard layouts; or Alt-Tab and Shift-Alt-Tab for the rest of us).
- New: When you hit Enter/Return in an indented line, the new line will be indented as well.
- New: You can now comment the selected text with Cmd-/ or from the “Format” menu.
- Fixed: Captured images from your webcam now produce a valid path with percent encoding.
- Changed: The Quick Entry window now has a sensible minimum size.
- Changed: The text editing caret is now twice as fat!
- Changed: Typing brackets (and Markdown syntax stuff) right in front of existing text now does not insert the closing brackets anymore.
- New: Bold (⌘B) and italics (⌘I) shortcuts. You can set your preferred Markdown emphasis character in the “Editing” preferences.
- New: You can set which external editor is used when you hit “Open with External Editor” (⇧⌘E).
- New: Links to images in the media subfolder are now clickable.
- New: Your preferences for spell checking, quote substitution, and things like that are now saved between launches.
- Fixed: Markdown list items starting with a
-were not indented properly.
- Fixed: With Typewriter Mode and Markdown highlighting enabled, you couldn’t scroll up without the app snapping back to the insertion point in the text.
- Fixed: Pre-installer filter icon picker shows icons at their proper size.
- Fixed: Right-click contextual menu works again in the search results list.
- Fixed: Keyboard shortcuts (cut, copy, paste) and text expansion apps should now work in the Quick Entry panel.
- Changed: The Quick Entry panel’s optional title text field is styled like the content text field.
- Changed: You can now edit text of error reports before composing the email to redact the contents.
- Changed: Improved Markdown syntax highlighting. Lists now indent more beautifully. I love lists. And I love how they behave now. I bet you’ll love it, too.
- New: Themes.
- New: Live Markdown syntax highlighting. It’s a awfully hungry for energy at the moment, especially for larger files, so you can disable it from the main menu if needed.
That’s about all I’ve been working on, shockingly.
- Fixed: Hashtags now support umlauts, chinese characters, and whatever else is considered a letter according to Unicode.
- Fixed: When you click out of the text editor and then back again, you can now undo changes from before clicking away.
- Fixed: Renaming a note to include a
/resulted in an error.
- Fixed: An error when using a note title with illegal file name characters in the Quick Entry Helper.
- Changed: Reverted replacing colons in filenames. It’s enough to take care of
/to make macOS’s file system happy.
- New: Remember the insertion point in the text when you tab out of the note and then back again. Makes shortcut-heavy workflows in the same note easier, like ⌘L + ⌘C (copy note title) + Tab + ⌘V (paste title into text).
- New: For dark and very bright backgrounds, use a tasty blue-ish caret color.
- Fixed: Switching the displayed note did scroll far to the bottom of the note. Now it starts at the beginning again.
- Fixed: Show filter sidebar slide-out thingies again.
- Fixed: After renaming a note, delayed file saving changes resulted in periodic replacement of the editor content with outdated text. Extremely annoying when you were still typing!
- Fixed: The insertion point or selection is preserved when the note updates in the background, for example due to a file change with an external editor.
- Changed: Activating a filter via shortcuts or sidebar or menu item closes the current note and puts focus inside the Omnibar so you can navigate more quickly.
- New: Plain-text quotation marks (
') behave like brackets: you can wrap the selected text with them, and they always come in pairs.
- Fixed Crash on launch for macOS El Capitan.
- New: Typewriter scrolling!
- New: Autocompletion and selection wrapping with brackets, underscores, and asterisks! Select a text, hit
*, and it’ll be surrounded by default!
For this release, I created an open source library for the Typewriter stuff, aptly called
Typewriter-Modes, so this project produced 5 libraries so far.
- Fixed: Replace “:” and “/” in file names with “-“. Dropping files into the Omnibar and hitting enter now doesn’t crash anymore.
- Fixed: Display glitches for long notes when hiding the sidebars.
- Fixed: Insertion point in the text editor is nudged up to look more conventional.* Changed: Performance when handling huge archives is improved. Search results still do not appear instantly, but it’s better.
- Fixed: Sidebar width or it being hidden is preserved across program launches.
- Changed: Renamed “Close Archive” to “Switch Archives”.
- Changed: Deleting a note does select the Omnibar with the note’s title, but it does not empty the Omnibar anymore.
- New: Added “Copy Title” to the search result contextual menu.
- New: Display an error report with a list of files that cannot be read after launch instead of showing a serious error alert for each file.
- New: Without a selection, hitting the up-arrow inside the Omnibar selects the last item in the search result list.
- Fixed: Changing the file you are editing from another app does not lose your current changes in The Archive. (Dropbox sync used to reset the file sometimes to the previously saved version. Also, editing a file and clicking a
[[Wiki Link]]sometimes did lose the changes when showing the target note.)
- Changed: Reorganized the “Editing” prefereces.
- Fixed: Fix revealing same note in finder twice not doing anything.
- Fixed: Fix editing same note in default editor twice not doing anything.
- Fixed: Undo note deletion selects the restored note properly, showing the title in the Omnibar.
- Fixed: The “Don’t show this message again” setting for the deletion alert is preserved. You can re-enable this at the bottom of the “General” preferences.
- Fixed: Font preview box displays the top of the font now and grows taller.
- Fixed: Changing archives closes the main window.
- Changed: Hitting ESC or ⌘. in the text editor resets the search.
- Changed: Saving note changes preserves the creation date.
- Changed: After deleting a note, the Omnibar is cleared.
- Changed: Improved startup times (a.k.a. initial indexing of all notes is faster).
- Changed: When you click a hashtag, the Omnibar is focused now.
- Fixed: Filter menu shortcuts work now even before you peek at the menu.
- Fixed: The clear button now hides itself again.
- Fixed: Tabbing out of editing a note’s title now puts the focus into the text editor instead of the Omnibar.
- Fixed: On macOS Sierra, the search result backgrounds now don’t have the see-through effect anymore.
- Fixed: Fast typing sometimes made the whole Omnibar contents be selected so that the next keystroke would overwrite everything. This was because the search results wrongly triggered a selection event. Doesn’t happen anymore.
- Changed: Disable text substitutions in the editor pane.
- Changed: Omnibar title suggestions don’t remember the last suggestion anymore. So if you search for “2017” first, get a suggestion, then start anew with “20”, the old “2017…” suggestion is now discarded.
- New: “Reveal in Finder” (⌘⇧R) added below “Notes” menu.
- New: “Open with External Editor” (⌘⇧E) added below “Notes” menu.
- Fixed: Notes are now sorted in a natural-language way, so “10” comes between “9” and “11”, not between “1” and before “2”.
- Fixed: Starting the app shows all notes. (At least I couldn’t reproduce the problem anymore.)
- Fixed: Flickering in the editor window when searching for notes.
- Fixed: Clicking a
[[WikiLink]]will always select the matching note. Previously, a bug sometimes cleared the selection in the results list.
- Fixed: Tabbing from Omnibar to the editor works again.
- Fixed: Moving the result selection with the down-arrow key from the Omnibar now doesn’t jiggle the scroll position at the bottom anymore.
- Changed: Improved type-for-filtering reaction speed for large archives.
- Changed: Improved scrolling and keyboard-based selection change speed in results view.
- Changed: Improved performance of command-tabbing back into the app. It took about a second previously.
- Changed: Double-click in the results list starts editing, even when the note was selected already.
- New: Added contextual menu (right-click menu) to the results list for deleting and renaming notes.
v0.2.3 & v0.2.4 (2017-06-07)
- Fixed: Window can resize vertically again.
- Fixed: Flickering and sometimes lost selection in the results list when clicking a
[[WikiLink]], problems introduced in v0.2.2.
- Fixed: Clicking a
[[WikiLink]]to a matching note selects and shows the contents of the best match so you don’t have to click inside the search result list.
- Fixed: Filter shortcuts were gone from the main menu. Now they’re back again.
- Fixed: A ton of issues with the Omnibar. Again. It should be more reliable now. I will not say it’s 100% working, because this little bugger showed me quite often how to crush my coding confidence, but it’s close!
- Changed: Selecting a filter now replaces the search completely instead of appending pieces to it.
- New: You can now configure which file extensions The Archive should use for note files.
And another open source library, resulting in 4 libraries from this project! The new one is called
Omnibar. Guess what it’s for :)
This release has many small fixes and a lot of bigger changes. The list sums up some of them, but the behavior and “feel” of interacting with the app should have improved. Whatever you notice, please email me with your opinion on the changes and where you experience most friction.
- Fixed: The Omnibar behaves better. There were so many weird edge cases whenever I fixed one thing that I lost track of what has changed. But the problems are gone and the behavior should be just fine.
- Fixed: Hitting enter in the Omnibar didn’t start editing the note when the note wasn’t selected.
- Fixed: Selecting an archive directory that is not readable/writable presents an alert instead of silently failing.
- Changed: The search is now a whole magnitude faster. In turn, the auto-completion got more reliable better.
- Changed: Filters work differently now. They immediately affect your search and don’t create a subset of your notes in a hidden fashion.
- Changed: Clicking a
[[Wiki Link]]no longer creates non-existing notes. These links are now just search shortcuts.
- New: Background auto-saving of note changes every 5 seconds.
- Fixed: After launch, not all notes where displayed for everybody. Should now be fixed. It’s hard to reproduce, so please send reports with log files if it still happens!
- Fixed: Deleting notes in large archives did not always remove the note from the search results list. Now it does.
- Fixed: Deleting notes that were created in the Quick Entry helper as soon as possible triggered an error, too. Had the same latency-dependent reason as the fix above this one. Time sucks.
- Fixed: Deletion bug where the wrong note was attempted to be removed.
- Fixed: Renaming bug that performed the change on disk but displayed an error nevertheless.
- Fixed: Hitting enter in the Omnibar did not always began editing the note.
- Changed: Hashtags in brackets or quotes are now clickable.
- New: “Capture Image” in the edit menu lets you create snapshots to quickly include drawings into your notes.
- New: Configure the path where snapshots are stored relative to your archive. Defaults to
This release introduces yet another open source library I created, now 3 in total. This one’s called
- Fixed: Clicking a hashtag does not deselect the currently visible note.
- Fixed: Don’t select a random note after start.
- Fixed: Keep note selected in the results list when the search results change.
- Fixed: Archive is faster when reacting to links. – Is performance a “fix”? Well, higher reliability is! Medium-sized archives (Sascha’s and mine with 4800 and 3800 notes resp.) didn’t always follow clicked
[[Wiki Link]]s. If you had looked at the event log, you’d see that a lot of stuff would go on, sometimes leading to showing the note with the link again instead of the link target. But no more!
- Fixed: The Omnibar. Like, in total. There were so many different edge cases over the last couple days that I cannot recall what was wrong initially. Especially in large archives with the current SuperSlowSearch™ it became unusable. Look out for this:
- When you click a
[[WikiLink]], the Omnibar should display the link text. If the target note is not among the filtered search results, reset the search to display it in the results list. Keep the search as it was otherwise.
- When you click a
#hashtag, the Omnibar should display the tag as search term, ultimately resetting the search. (But not the active filter!)
- When you type, the Omnibar should show the characters you’ve typed, no matter how slow the search. Your will is its command.
- When you type and a note among the search results begins with your search term, the Omnibar should auto-complete your input and display the note in anticipatory obedience.
- When you delete parts of the search, auto-completion should not be active. Only when you type. Also, the display should reset to “nothing”.
- When you click a
- Changed: Perceived performance when searching is better. When you type faster than the SuperSlowSearch™ can sift through your notes, you won’t be interrupted, the app won’t freeze, and it won’t show outdated auto-completion suggestions. On the flip side, if you want to see intermediate search results in huge archives, you have to wait at the end. This is an interesting psychological effect: Since the typing up until the end is now undelayed, the single and final delay feels like an eternity. Before, you got used to the slow response time. It was annoying, too, but different.
- Changed: Printing is disabled for now because the system’s default is pretty useless. Will come back with a revenge later during the beta.
- Changed: Changing a note but then undoing the change no longer touches and overwrites the file to reduce disk load. (And to keep the event log smaller. 😁)
- Fixed: Hiding the sidebar does not shrink but grow the note text editor as expected.
- Fixed: Filename conflicts when renaming notes are now resolved by appending
.3, … (whichever is free) to the desired title.
- Fixed: Clicking on
#hashtaglinks now searches for notes with that phrase instead of creating a note called
[[Wiki Links]]still work as expected: they search for a note starting with the link content or create a new note if none exists.
- Changed: Sorting options in View > Sort By are now less clever and say what you’ll get on the tin.
- Fixed: Window and results list sizes are restored when re-opening the app.
[[Wiki links]]are now clickable when you add parens around them. Or punctuation marks.
- Fixed: The directory selection panel now shows the “New Folder” button y’all have been missing so badly.
- Fixed: Searching in the Omnibar now does not replace the case you typed in when auto-completing suggestions. So if you have a note called “Banana” and you type “ban”, the Omnibar will show “banana”. Also, this way you can start note titles with different cases than existing notes starting with the same letter :) (Thanks to Rocco Nicosia for finding that one!)
- Changed: The results list shows numbers in monospaced variant so your note IDs are all of the same width.
- Changed: Before deleting a note, you’ll now get a confirmation dialog.
- Changed: The archive selection window is now less ugly.
- Changed: The divider of note editor and search results is now thicker for better partitioning of the space available.
- New: The help menu has new items to send feedback and get to this website.
- Fixed: Double-hash hashtags (
##example) are now clickable. Sascha uses them for broader categories in his archive.
- Fixed: Creating an empty note now selects and edits the new note automatically.
- Fixed: Clicking a link triggers a search (and puts the cursor into the Omnibar). If there is a partial matching note (a note that starts with the link anchor text), that note will be selected and editing starts. This way you can use wiki links to IDs like
[]and jump to the note right away.
- Fixed: Creating a new note aborted editing after a couple of seconds because the Finder/file system updates the file in the background again. These background refreshers should not affect your active editing session anymore.
- Fixed: Changing a note, then focusing the Omnibar deselected the note and displayed “Nothing Selected” instead of the note’s text.
- Fixed: Quick entry helper updates with colors and font changes.
- New: You can change the font size of the search results list on the left. BIGGER TEXT FOR EVERYBODY!
- Fixed: entering an existing note title in the Omnibar, then hitting enter, previously resulted in an attempt to create the same note twice.
- Fixed: The Omnibar now shows the title of the selected note as you change the selection.
- Fixed: The note editor now scrolls. For real.
- New: Typing in the Omnibar selects a note from the results that starts with the exact title. Since IDs are at the beginning, this is pretty much useless for regular Zettel notes unless I make the archive “Zettel-aware”, that is treat notes with IDs differently.
- New: Hitting Enter in an empty Omnibar creates an empty note and displays it.
- New: “X”-button to clear the selection added to the Omnibar.
- New: ⌘C (copy) from the search results list is now possible.
- New: The search results’s background color now changes with the editor color.
- New: You can specify the minimum inner distance between the editor text field’s border and the text, also known as inset or padding.
- Changed: Searching inside a note using ⌘F does not display a separate window anymore but the more modern “search bar” at the top.
Known issue: replacing content from the search bar is not undoable.
I won’t list everything I did to get this first useful version up and running (and kinda polished, compared to my first TableFlip build) because “a running app with functionality” is pretty self-explanatory already. We have text file editing, a quick entry helper, editor style preferences, and filter management, basically.
Instead, here are some fun facts:
- Thanks to all the open source libraries I use (including self-made ones), the overhead affecting the file size is huge: this version takes up 38 MB of disk space. 😱 Is this really the future? Then again, any Electron-based app (like Slack, VisualStudio Code, Atom, and numerous others) will need at least 110 MB because there’s a full Chrome browser included.
- I started my first experiment in code on 19th November, 2016. (And I didn’t do anything for most of March thanks to my post-op.)
- It took 697 source code repository commits (= micro milestones I checked in) to get this far.
- With 921 unit test cases, this is the project with the most automated test I ever wrote on my own. (Projects where I did work in a team had significantly less tests, by the way.)
- I extracted and published 2 new open source libraries in the process,
BetaExpiration, and updated another one that I published back when I released TableFlip for beta, called