April 4, 2018

HomePod Makes My Life Better

My HomePodMy HomePod

Product: HomePod
Price: $349

My requirements of a connected speaker are different from most other people.

I was looking for a speaker within an "acceptable" price range, which sounded "good" to me. I was using a set of Bose Companion 2's. They are not bad for the price. There is only so much speaker you can get for $99. I wanted a speaker or set of speakers which sounded better than the Bose.

Most of the criticism of the HomePod centers around the inadequacies of Siri. I find myself a little self-conscious when speaking to an inanimate object. Siri thus was not a major feature behind my decision. I am happy asking Siri for the weather forecast and the news from NPR, but that is about it. Sometimes I like the ability to mute the speakers or ask it to play the next track. My use of a digital assistant I can speak to is severely limited. I understand this is not shared by most people. I see people interact with Siri or Alexa or Google a lot more than I am comfortable with.

It is fair to say that I am only interested in the sound that comes out of the speakers.

The HomePod sounds fantastic. I stream music from Apple Music and Spotify. Both sound crystal clear to me. I use Audirvana Plus to play my digital music and it sounds great. I am going to review Audirvana Plus one of these days. In the meantime, I must say that it has made my music sound better than played through iTunes.

I use Airfoil to stream music to my HomePod from Audirvana Plus and a whole host of other audio sources. It gives me two things:

  1. The ability to stream music from any application I want.
  2. Gives me the ability to use an equalizer to stream music to the HomePod.

These are a few of the albums I used to test the HomePod:

Muddy Waters - Folk SingerMuddy Waters - Folk Singer
Muddy Waters - Folk Singer is an acoustic blues album.

Ustad Amjad Ali Khan - SarodUstad Amjad Ali Khan - Sarod
Ustad Amjad Ali Khan - Sarod is the sarod maestro playing the Rag Pilu and Kirwani

Al Di Meola, John McLaughlin & Paco de Lucia - Friday Night in San FranciscoAl Di Meola, John McLaughlin & Paco de Lucia - Friday Night in San Francisco
Al Di Meola, John McLaughlin & Paco de Lucia - Friday Night in San Francisco. This is a live album of three great talents.

Pink Floyd - Wish You Were HerePink Floyd - Wish You Were Here
Pink Floyd - Wish You Were Here is the Pink Floyd album I like best.

Ustad Hariprasad Chaurasia - LalitUstad Hariprasad Chaurasia - Lalit
Ustad Hariprasad Chaurasia - Rag Lalit is the artist playing a bamboo flute and the Rag Lalit.

I am intimately familiar with these albums having listened to them more times than I care to recall. They sound awesome on the HomePod. Both the actual CD and the digital files sound perfect on the HomePod. I am impressed with the sound quality.

What was surprising to me was that I heard things in albums I haven't heard before. Albums I am intimately familiar with sound fuller and encompassing with the HomePod.

Pink Floyd - Dark Side of the MoonPink Floyd - Dark Side of the Moon

Pink Floyd - Dark Side of the Moon includes sounds I have never heard before.

Tom Waits - Small ChangeTom Waits - Small Change

Tom Waits - Small Change makes Tom's voice sound even more gravelly than I expected.

Miles Davis - Kind of BlueMiles Davis - Kind of Blue

Miles Davis - Kind of Blue makes me feel that he is in the room with me.

Djivan Gasparyan - Ask Me No QuestionsDjivan Gasparyan - Ask Me No Questions

Djivan Gasparyan - Ask Me No Questions makes me cry.

I am not a sound guy. My ears are not all that good. I have spent ten years or more of my life with headphones attached to this lovely machine. The HomePod sounds good to me. It has brought music back to my life in a way I haven't had in a long while. Incidentally I got the Space Gray one.

The HomePod was a gift for my birthday. Thank you.

If you are interested in a life enhancing experience, I suggest you get yourself a HomePod. I recommended it heartily.

macosxguru at the gmail thingie

Music HomePod
April 1, 2018

MWeb Brings Skills to the Genre

MWeb IconMWeb Icon

Product: MWeb
Price: $14.99

Loren of ldstephens asked for a review of MWeb. So here goes.

MWeb is a surprise. It is a deep product which improves on both Ulysses and Bear in some areas and brings some unique skills to the Markdown editor genre.

It is the usual three-pane Markdown based text editor. Similar to LightPaper, TextNut - A CommonMark editor for Mac, Bear - Notes for iPhone, iPad and Mac or Ulysses to name a few. This category is a competitive category in the macOS marketplace.

I have myself covered a whole host of them:

  1. WonderPen Is a Tad Short on Wonder
  2. TextNut Reimagines Zen Mode
  3. Bear Is My App of the Year
  4. The Prodigal Son Returns to Ulysses
  5. LightPaper: One App for Your Markdown Needs. With a Few Nifty Extras.

MWeb does a lot of things well and hasn't gotten the attention it deserves in the marketplace. It is a product which is getting lots of developer love and is steadily being improved giving me another reason to write about it. I am surprised by the feature set of MWeb and am excited to tell you about it.

Features Galore

MWeb supports the Github-flavored Markdown variant of the Markdown flavors. That means it supports TOC, Table, Fenced code block, LaTex, Task lists, Footnotes, etc. Github-flavored Markdown(GFM) is a full-featured Markdown variant. This makes the product different from both Ulysses which barely supports Markdown and Bear which is struggling to take the product beyond the basic Gruber Markdown.

MWeb is a native macOS application. Thus it is fast, stable and intuitive to the Mac user. It supports features standardized on the macOS like multiple tabs and text expansions (with some caveats).

MWeb has an iOS version, but I have not tested that.

Library to Manage Your Files

Like Ulysses, MWeb gives you two different libraries to work in.

  1. Library (⌘L), contains the files you create in MWeb's Library. This is a SQL library which adds some efficiencies like cross-note linking. Bear also has a SQL backend. The difference is that if you explore the folder that MWeb terms its Library, it will contain a folder of your files in plain text format. You have access to the plain text files if you want to access them in another program on your iOS devices through any old text editor. Bear does not give you this opportunity.
  2. External (⌘E) is a collection of files within folders that you ask MWeb to manage. These are the collection of plain text files that are residing on your hard drive. This is similar to the External files maintained by Ulysses. There are two big differences between the way external files are maintained by Ulysses and MWeb. Ulysses has a tendency to change the external files that you ask it to maintain. Inline links become reference links if you do not explicitly stop Ulysses from doing stupid things. MWeb reads them as plain text files and doesn't change these files unless you specifically edit them. The second major difference is that Ulysses only supports a subset of its Markdown syntax for external files. MWeb doesn't make any such distinction. All files have full support for GFM.

Interface To Live In

MWeb InterfaceMWeb Interface

I am going to highlight the interface through the External Library, simply because I use that a lot more. I like having my text files in assigned folders and having them accessible through any text editor I fancy at the moment.

On the left is the listing of folders that you have added to the External Library. On it's right is the list of files in the folder. The main window is the Editor window. MWeb supports the macOS tabs and they show up at the top of the editing window.

Toolbar. MWeb has a toolbar. This is the most discordant feature of the writing environment. The icons are useful in that they help you write Markdown, however, the product is not geared towards the novice Markdown writer. The product features are geared towards people who are comfortable with taking their Markdown based writing beyond the scope of the simple Markdown editor. Examples include the support for LaTex, code highlighting and the whole suite of features from GFM. The toolbar is specially distracting in full screen mode. There is an option to hide the toolbar and I seem to be using that all the time. I have a Keyboard Maestro macro assigned to a typed string trigger which lets me turn the toolbar on and off.

Keyboard Maestro macro to toggle toolbarKeyboard Maestro macro to toggle toolbar

Since the command does not have a keyboard command assigned to it, my Keyboard Maestro macro gets a lot of use. The good news is that the toolbar commands almost all have keyboard commands assigned to them. Learn them and you don't have to use the toolbar at all.

Dark Mode. MWeb implements a Light Mode and a Dark Mode. You have the option of assigning a specific theme to each of these options. I find myself using Solarized Light in Light mode and Solarized Dark in Dark Mode. Again, this switch between Light and Dark Mode doesn't have an assigned keyboard command, and a Keyboard Maestro macro with a typed string makes this easy to access.

Keyboard Maestro macro to toggle toolbarKeyboard Maestro macro to toggle toolbar

Document Outline (⌘7). MWeb provides you the ability to look at the outline of your document and navigate through the various headers in it. You click on the header you want to get to and you're taken to it. This is useful when you have a long document you are working on.

MWeb Document OutlineMWeb Document Outline

Writing Environment

This is the most important part of a Markdown based text editor. How does the Editor help the writer? This is what distinguishes a Markdown based product from a simple text editor.

Markdown Support. MWeb supports the full suite of GFM Markdown syntax.

Links (⌃⇧L). MWeb supports links in that it lets you press a keyboard command and it inputs the syntax for a link. If you highlight the word or phrase that you want to turn into a link, select it and press the keyboard command ⌃⇧L, the selected word or phrase gets surrounded by square brackets, a set of brackets are appended to the square brackets with the cursor in the middle waiting for you to fill in the URL. It is useful. I would have liked it if the feature was a little more developed. If I have an URL in the clipboard, I want it automatically inserted surrounded by brackets. I should also be able to drag an URL or copy/paste an URL to a highlighted word or phrase to make proper Markdown formatted links.

Lists. MWeb supports both unordered(⌃U) and ordered(⌃⇧O) lists. It auto-completes the lists syntax making it easy to make them. You can highlight a block of lines and press the specified keyboard command to get the kind of list you want.

Table Editor. This is a feature which Ulysses and Bear have failed to include in their offering.

MWeb Table EditorMWeb Table Editor

The Table Editor in MWeb is well implemented and it is useful for those of you who need tables in your writing. I am amazed that this feature is still missing in the two prominent note-taking applications in the marketplace. MWeb's table editor is comparable to the one in Typora. These two are the best in class when it comes to tables support in Markdown based text editors.

Code Highlighter. Another feature which seems to be difficult to implement for Ulysses and is well supported by MWeb.

Drag and Drop Image Support. You can add images to your document with simple drag and drop. It is integrated into the export to several blogging engines.

LaTeX. You can live preview LaTeX code in your document. Something useful to those of you who are a tad geeky.

Publish to Various Blogging Services

MWeb BloggingMWeb Blogging

MWeb supports publishing to a whole slew of blogging engines. It is not a feature which is particularly useful to me. I blog at Blot which means that I use plain text files in an assigned Dropbox folder. Don't need a blogging application. It might however be useful for some of you.

Export to Different Formats

MWeb ExportMWeb Export

MWeb provides you the usual tool chest of export formats. You can export your document to Rich Text, PDF, HTML, RTF or .docx files from the external libraries. When you are in the internal library you can export, in addition, to Markdown text files. You are not burdened with any proprietary formats in MWeb.

Backup Your Writing

MWeb BackupMWeb Backup

A writing application needs to have a backup routine in-built and MWeb doesn't disappoint. Three unique locations to backup your files. Gives you peace of mind. I approve.

Suggestions for Improvements

  1. Make it easier for the user to insert links. Highlight a word and press a keyboard command to surround the highlighted word in square brackets and copy the URL in the clipboard next to it after surrounding the content with brackets.
  2. Support macOS conventions. I can set up text completions in the System Preferences. Two spaces equal to a period (this is supported). Start every sentence with a capitalized letter (this is not supported).
  3. Give me an option to convert amongst different list types. Ordered, unordered, task list and plain text. A toggle command would be ideal.
  4. The help video is great. It gives you an overview of the features, but please add an audio track to it.


MWeb is a surprise. It does a lot of things well. It is a full -featured Markdown based text editor which deserves more attention than it gets. These are the things I love about it:

  1. Full support for Github Flavored Markdown.
  2. No proprietary file format. Just plain text files.
  3. Table Editor.
  4. Support for macOS conventions.
  5. Support for a wide range of keyboard commands.
  6. Continued development.

If you are looking for an application to live in with your Markdown files, MWeb is a competent and cheaper alternative to both Bear and Ulysses. It might not be as pretty but it is more capable a Markdown editor than it's competition.

I recommend MWeb heartily.

I was provided a promo code by the developer for the macOS App Store version.

macosxguru at the gmail thingie

MWeb Markdown text editor macOS
March 14, 2018

The Archive Adds Zettelkästen to the Note-Taking Arsenal

The Archive iconThe Archive icon

Product: The Archive
Price: $19.99

Note-taking Demystified

There are many reasons why you take notes:

  1. Information Gathering. You come across something interesting about a subject matter you are interested in and make a note of that. This can take the place of a whole page/pages in a web site and you want to keep a pdf file of the content. You might want to note the URL of the web page and your thoughts about the content of the page. You take notes because you are engaged in the process of gathering information about a topic.
  2. Learning. There is the need for note-taking when you are learning about a subject. You read about the subject and you want to synthesize the learning and you want to keep this synthesized information for further exploration or as a memory bank item.
  3. Creating. Sometimes your note-taking deals with the creation of knowledge. You learn new things, you react to it. You collect various pieces of information and you bring different perspectives to the information and try to distill it into a web of knowledge that is unique and yours. Unfortunately this process doesn't happen in one shot. It is a progression and the notes you take on the subject grow and mutate over a period of time, or over a lifetime.

Irrespective of the motivation behind your note-taking, there are some questions which are central to this activity:

  1. How easy is it to take notes?
  2. How easy is it to get back to a note?
  3. How to build on the knowledge of your notes?
  4. How easy is the search function?
  5. How do you link the notes to each other to create a web of knowledge on a subject?
  6. How do you ensure that this body of knowledge is going to stay with you for the rest of your life and not be dependent on any particular piece of software being available?

Many people have tried to understand and provide answers to these questions over the years. The Zettelkästen Method is one answer to some of these questions.

Luhmann, the primary exponent of the Zettelkästen Method is the first one who used a hypertext approach and propagated a system that worked with paper. His big contribution to the system was to assert that every individual note had a fixed position. He eschewed the use of categories which would have allowed the notes to move freely within the categories. Every note had a fixed ID, every subsequent note had its own fixed ID, if they were related to a previous note, the ID would be build on the previous note. For instance, the initial note might have had an ID of 5. The subsequent note would have the ID 5a. The next note building on this would be 5b, if it branched off in a different direction it would be 5a1. And so on.

This led to the first of Luhmann's principles: A flexible branching capability. The archive grows along the train of thoughts organically and is not pre-determined by a system of fixed categories. Categories are problematic because you have to choose them before you start, but at that point you do not have a clue where the journey will be taking you. (If you knew in advance, it would not be creative knowledge work.)

A body of knowledge which grows over time has to build in some sense of connection between the notes. For the notes to be useful, they have to link into a pertinent web of interconnected information. Which leads us to the second of Luhmann's principles, connectivity.

With IDs and fixed positions, you can link from one note to another. If the position in the archive changes, the link would break and you couldn't find the note again. Remember that in the case of Luhmann's notes we are talking about paper. (Luhmann had 66,000 notes in his second archive, by the way. No chance of finding something that got filed at the wrong position.) In the digital realm, this is important when you have a collection of notes on different topics. The notes are connected by their topic or area of focus and it helps to have the ability to connect them when creating them to build a web of knowledge which leads you to understand the subject under scrutiny.

The third principle is to have a register. This was the first entrance for Luhmann if he wanted to get started communicating with his archive. This was in the form of an index. In the digital world, this is not that important. We have full text search and can search for tags directly in our archive.

If you want to read a translation of Luhmann's article "Kommunikation mit Zettelkästen", where he talks about his method, written by Manfred Kuehn, follow this link: Communicating with Slip Boxes by Niklas Luhmann.

The Archive Attempts to Tackle Note-Taking

The Archive owes a huge debt to nvALT. The developers acknowledge that debt explicitly. The Archive is nvALT improved.

The Archive WindowThe Archive Window

The Archive has four main components:

  1. The Omnibar. This is the place you type to search and create your new notes. It is a dual-use window to search your archive, and create new notes. Type something in the Omnibar and the application searches through your archive for the words you typed. A subset of your notes show up in the Sidebar, listing the notes that contain the words you typed. The Omnibar is also where you type the name of the new note you are creating. Just type the name of the new note and hit enter. You are now ready to add the contents of the note in the Editor window.
  2. The Editor. This is where you write your note. It is a Markdown compliant editor. Supports Gruber's Markdown.
  3. The Sidebar. This is the list of your notes. It is dynamic in the sense that it changes depending on what you have on the Omnibar. If the Omnibar is empty of content, this is the list of all the notes in the folder of the archive. If the Omnibar has some content, the Sidebar contains the files which contain the words in the Sidebar.
  4. Saved searches. In The Archive you have the ability to save frequently used searches and they show up on the side.

The Editor

This is where you are going to spend most of your time in this program. It is Markdown compliant. It supports Gruber's Markdown. Unfortunately, the technology has moved on from that basic implementation and now there are many different flavors of Markdown. I would have preferred support for CommonMark. Markdown support in these new incarnations like CommonMark, MultiMarkdown, and Github Flavored Markdown, has been extended to tables, table of contents and footnotes. The implementation of Markdown in The Archive does not support any of these enhancements to Markdown. This hampers the editing function in The Archive. The good news is that The Archive includes an option to edit the note in an external editor (⇧⌘E). So in a note which has the need for advanced Markdown support, I use the option to edit the note in my designated editor, Composer. I edit in Composer and use The Archive to manage the files. You have the ability to designate your favorite Markdown editor in the preferences as the external editor.

The Archive is a nice place to write in. The editor supports syntax highlighting for Markdown and does have some nice touches like typewriter scrolling built in. I would have liked extended support for writing Markdown. For instance, the program supports automatically completing the brackets used in Markdown but it could add support for some features that make writing Markdown links easier:

  • Highlight a word and copy an URL from your clipboard to make that word a link.
  • Highlight a word and press a keyboard command to put the word in brackets and let me add an URL surrounded by brackets.

The editor lets you do away with the sidebar when you are writing (⌃⌘S). That gives you a barebones editor window. It is useful if you want to limit distractions and write in The Archive.

Saved Searches

Saved SearchesSaved Searches

If you have a fair few notes (my archive of notes contains about 2800 notes), you are going to be periodically performing searches on the notes. The Archive gives you the ability to save searches you regularly perform. They show up in the leftmost panel. You can assign icons to help you identify them. There is a pop-up indicator panel if you hover your mouse cursor over the items. You can assign a keyboard command to a saved search. This is an example of the attention to detail which makes The Archive an absolute pleasure to use.

Saved searches makes it possible for me to build a repository of some of the repetitive searches that I find myself doing when I interact with my collection of notes. Saved searches are analogous to smart folders in the macOS world and are an useful addition to the act of interacting with my notes.

The Archive Improves on nvALT

I love nvALT. I have been using it for years. Brett Terpstra and David Halter, building on the core of Notational Velocity, have created a product which has grown to define note-taking on the macOS platform. The Archive improves on nvALT in several ways.

The Ability to Use Multiple Archives

Switch ArchivesSwitch Archives

nvALT has always been constrained in that it supports one folder of notes. Changing the archive of notes to a different one required a fair amount of work. The Archive gives you the ability to have several archives of notes, and the process of switching between them is convenient and quick.

Choose Switch Archives… from the The Archive menu and you get to select the folder containing a different archive of notes. For those of you who want to keep separate archive of your notes, for instance, a folder for your personal notes and a folder for your work notes, this is a feature which is going to make you happy.

Provides a Theoretical Framework to the Process of Note-Taking

nvALT and its predecessor Notational Velocity were both a system for dealing with your notes. They were not build around a theoretical framework of any kind. They were focused on providing you a way of dealing with a bunch of files in a folder. They performed that task well, but The Archive extends the paradigm by providing the tools which weds your note-taking to the Zettelkästen method. Extending the product allows the user to see a process. To understand and use the notion of a progression of knowledge gathering, cultivating and creating. Your notes under The Archive is not a collection of individual notes. It is a collection of interconnected notes which has the potential for expansion and illumination by means of the linkages between them.

What was once a bunch of notes can under The Archive be conceived as a growing organism which builds on each other to create a web of knowledge. I am most excited by this aspect of The Archive. It has allowed me to delve into my notes and rearrange them to take advantage of explicit and implied linkages among them.

Ignore the Theory. Handle My Notes.

If you are not interested in Zettelkästen and just want to write notes and manage them in The Archive, it does that fine. You do not have to think about any underlying theory or framework to interact with your notes. Think about The Archive as the application which manages your notes and have at it. You can setup The Archive any way you want to, that makes it possible to keep using your old notes files and not worry about a new way to do things. The Archive handles text files with any plain text extension you throw at it.

Saved Searches Are Convenient

The idea that you can define a search criteria and save it for future use makes the task of handling a large number of notes easier. I can work on a smaller segment of my notes and be focused on the subject that I am working on. Makes it possible to intelligently segment my notes through the use of tags and saved searches aids the process of retrieval.

Stability and Peace of Mind

nvALT being freeware is dependent on the developers maintaining the project. There is no commercial reason for Brett or David to spend a second of their time on making sure that the product runs on the latest iteration of the macOS. They have been fantastic in making sure that the program runs and runs so well in High Sierra, but it is not a commercially motivated move. It is a labor of love. I am thankful to them for their continued support for nvALT.

However, I am always worried. I am eagerly waiting the advent of Bitwriter, the rumored commercial successor to nvALT. In the meantime, The Archive is a program which I have confidence in. This is version 1.0 from a developer who is interested in making the product a commercial success. Having participated in the beta program I am aware of the work that has gone in to the product to achieve the milestone release and am confident of a long and fruitful run in the marketplace. The developers of The Archive have a revenue stream to motivate them to keep working on this product and that gives me peace of mind. It is a product which does have the potential to become one of the dominant players in the field of note-taking on the macOS. This gives me peace of mind. I am putting my faith into a product which will be around for a while.

Software Agnosticism

The developers introduce a concept called Software Agnosticism to software development which is new to me. In simple words, this approach to software development has some discrete outcomes for the consumer which are easy to see:

  1. The goal of the product is to solve a problem. The problem in this case is note-taking and the goal of the product is to solve the problem through the implementation of the Zettelkästen method to the task of note-taking. The Archive is optimized to fit this problem.
  2. There is no lock-in. The end product of the file is plain text files. You can use any text editor you want to access and create these text files. Doesn't have to be The Archive. You are not dependent on The Archive for the continued access to your files. You can move on to another solution if that appears to be the best decision. This lets the user be in control of her destiny and not dependent on the vagaries of the software marketplace. If tomorrow something happens to The Archive or the developers do something to the product which makes it incompatible to my goals, I can take the collection of text files to any other program which fits my needs better without any friction. Very different from the Microsoft, Adobe and Apple way of doing software design.
  3. The developers themselves are keen adherents of the Zettelkästen method. They have "skin in the game." This is not only a commercial project for them. This is a way of life for them. This makes the act of adopting the product and the underlying concepts behind it, less risky for the consumer.

Setting up The Archive

The Archive has an adequate system of preferences which you can tweak to get the best experience customized for you.

The Archive Preferences GeneralThe Archive Preferences General

You can specify the location of your Archive folder. It can be a Dropbox hosted folder. That enables you to have the same collection of text files available across devices.

You can set a default note extension to use for your notes. Some people like using .txt, I am more comfortable with .md. Sublime Text 3 handles my .txt files. While Composer handles my .md or Markdown files.

The Archive lets you set a keyboard command for the global Quick Entry Shortcut. Also lets you assign an external editor of your choice , if you desire.

The Archive Preferences EditingThe Archive Preferences Editing

In the Editing panel of The Archive's Preferences you get to assign the font you want to write in. You get to control line width and the line height. You also get to control the amount of space around your text through the Editor Insets control.

Choose a theme. Define the markup for italics and bold. I like typewriter scrolling and am glad to have that available in The Archive.

Some Random features/thoughts

Note ID. I have always used descriptive file names for my notes. For instance, I might have a file called "Info - The Archive keyboard commands," which contains the keyboard commands which are available to me in The Archive. This system lets me have an alphabetically sorted list of notes on the sidebar. It is kind of an inefficient way of finding the file that I am interested in. When the archive of notes grew, I decided to include tags in the files. Tags help me collect similar files together and also lets me search my archive based on the tags. That is what I have been using till The Archive came along.

To create links between notes, you need to define how to target a note first. One response is to use file names. If you want clickable links the full path to the note could be used. However this is a fragile solution. It breaks when file names change or the location of the file changes. A better answer is to use an unique ID for each file. The Archive uses a timestamp ID. These timestamp IDs are by definition unique. For instance the timestamp ID 20180314211534 is based on the date 2018-03-14 and time 21:15:34. This is unique to this ID. If you name a file based on the timestamp ID, it will have an unique ID. Thus it will have the ability to be linked to by enclosing the ID in double brackets, which is how The Archive extends the ability of text files to link to other files. Try it, it is absolutely magic.

Changing List Type. You can create a list and change your mind about the kind of list you want. For instance, you have an ordered list. Highlight the list and select Format>Switch List Type or, press ⌘T. It changes to plain body text. Press ⌘T again, it changes into an unordered list. Neat and useful.

Tags. I love the implementation of tags in The Archive. The act of being clickable makes the tags useful and something that I have grown to rely on.

External Link URL Schemes. The Archive supports the following URL schemes:

  • thearchive://search/TERM searches for TERM as if you typed it in
  • thearchive://match/TERM works like the search but displays a good match directly; this is similar to [[Wiki-Links]].
  • thearchive://matchOrCreate/TERM will create a note of the exact title TERM if that doesn’t exist; it’s similar to entering a search term into the Omnibar and hitting the return key.

Scripting and automation experts can add Alfred workflows and Keyboard Maestro macros to talk to The Archive directly.

The Roadmap. The developers of The Archive explicitly make available on the product web site the roadmap for the product. Here: The Archive Roadmap • Zettelkasten Method. This transparency is rare and appreciated.

An explicit published roadmap lets the user know what the future of the product holds in store. I wish more software development houses were this candid and open with their users.

Resources. The Zettelkästen forum is a great resource for all things Zettelkästen. I have been learning from the other users of the forum for the past few months and it is a great resource for anyone interested in trying to optimize their use of notes.

Areas for improvement:

Any version 1.0 product has room to grow, and these are my suggestions.

  1. Highlight a word and paste an URL to create a Markdown formatted link.
  2. Support CommonMark or MultiMarkdown.
  3. A keyboard command to input header levels.
  4. Bring explicit support for Markdown tables into the editor. Integrate your other product TableFlip into The Archive or let those two talk to each other.


The Archive blends the power and simplicity of nvALT with the elegance and efficacy of a digital Zettelkästen system to bring order and clarity to your note-taking system.

I have been using The Archive for the last few months. Being a part of the beta program (I am the anonymous one) has given me an appreciation for the progression of the product, the dedication of the developers and the humanity of the community surrounding the product. I am honored to be a part of this exceptionally bright and generous community.

The product is well designed and efficient. The developers are responsive and thoughtful.

If you are serious about your note-taking, you need to give The Archive a trial. I recommend the product heartily.


Some of the material, specially the section on Zettelkästen is copied from the help files that Christian, one of the developers of The Archive wrote during the beta period.

macosxguru at the gmail thingie

Note-taking Zettelkästen macOS
February 21, 2018

WonderPen Is a Tad Short on Wonder

WonderPen IconWonderPen Icon

Product: WonderPen
Price: $9.99

WonderPen is another Markdown based text editor. It is from China.

One sentence review: It reminds me of Ulysses without all the attention to detail.

At the base, it is a Markdown based text editor. It is an Electron application. For those who care about that, it might be a deal breaker. For those who don't, this is an interesting product which lets you write on the Mac.

Like Ulysses and Bear it keeps its documents in a proprietary database and unlike them, it doesn't have an online component. No explicit Dropbox sync, no iCloud sync. Just a folder on your hard drive where the database resides. I suppose you can put the database in a Dropbox folder and access your documents through a second macOS device using WonderPen but I haven't tried that out.

It has some nice touches and some glaring omissions.

What WonderPen Delivers

WonderPen 3 PaneWonderPen 3 Pane

WonderPen gives you a three pane window to write in. The sidebar on the left contains your document hierarchy. The middle window, the editing window, and a memo window to the right. Every document in WonderPen has the ability to have an assigned Memo window where you can comment on the document and the content for your own reference. It is a nice touch which reminds me of a similar feature in Scrivener.

You can preview your markdown and there is an usable full screen implementation.

The left sidebar is the project sidebar, you can toggle this on and off (⌘1). Like Scrivener and Ulysses, WonderPen gives you the ability to write in small chunks. You can have a folder which contains parts of an article you are writing. So, you don't have to write it all in one document.


You can move these component parts around by drag and drop or by keyboard commands. This makes the process of writing a long document and arranging it easier. This is important when you export the document, the export stays true to the hierarchy of files you have created.

If you have a ton of projects in the sidebar, you can reduce distraction by focusing on the project you are working on.

You can save snapshots of your work from a particular state and return to that state. The snapshot history is accessible from the button on the right bottom corner.

WonderPen Dark ModeWonderPen Dark Mode

There is a dark mode and a light mode, but there are no themes or syntax highlighting in code blocks.

For an application which keeps your files in a proprietary database one of the important things to consider is how to get your documents out of the program.

WonderPen Export 1WonderPen Export 1

WonderPen has a comprehensive set of exporting options, you can export to a PNG file, a PDF file, word document (docx), text, and HTML file.

WonderPen Export 2WonderPen Export 2

I am interested in the text export and WonderPen does a great job of that. Giving me ample choices to make the product usable.

What WonderPen Doesn't Deliver

In random order of importance, things WonderPen doesn't do:

  1. Keyboard commands for Markdown. Yes, it does bold (⌘B) and italic (⌘I), but it doesn't support anything else.
  2. WonderPen doesn't automatically let you continue an ordered or unordered list. The whole process is manual.
  3. WonderPen doesn't support the autocompletion of brackets that makes Markdown writing easier. Nor does it make any effort to make it easier to include URL links in your documents.
  4. While it supports a well implemented full screen mode, it doesn't support typewriter scrolling.
  5. Doesn't support any form of spellchecking. There is a perfectly usable spell check function built into macOS, but WonderPen doesn't support that.
  6. WonderPen doesn't support text expansions built into macOS. Two spaces for a period or start every new sentence with a capitalized letter are not supported from the macOS system. This is disappointing because Caret which is also an Electron app does support the system features on macOS. So it is doable, WonderPen doesn't care about supporting those features.
  7. No support for Services, another aspect of macOS which makes it special and convenient to work in.

WonderPen Is Minimal in Its Preferences

WonderPen Preferences 1WonderPen Preferences 1

You can assign a folder for WonderPen to keep its database. You get to choose the font of the editor and the font of the UI.

WonderPen Preferences 2WonderPen Preferences 2

You get to choose to automatically backup, manually backup right now and access your backups through this preference pane.


WonderPen has promise. In its current iteration, is only a good place to write in if you are comfortable with Markdown. Otherwise there are better options available to you in the marketplace.

I liked the minimal ethos to the program. I like the approach to ordering your document contents through the sidebar and then exporting it out. The export options are adequate and I love the attention WonderPen lavishes on backups. Using the app to write this review I am enamored by its spartan UI. I find the lack of distractions helps me write.

The price is $9.99. Compare that to its more illustrious competitors: Bear costs $14.99 a year and Ulysses, costs $39.99 a year. WonderPen is not feature competitive with those products, but it has a similar three pane structure with the focus being on writing in text. WonderPen is the cheaper alternative. It is nowhere near as good as the competition but it is perfectly usable.

What is holding me back from giving WonderPen a full throated recommendation?

  1. The writing environment lacks polish. It lacks the care I associate with Markdown editors. No support for keyboard commands, no attempt to make Markdown writing easier. It performs more as a text editor and less as a Markdown editor.
  2. The support web site is in Chinese with a few English words strewn about. There is no way for a non-Chinese speaker to know the abilities of the program. There is essentially no documentation available for the non-Chinese speaker. If you make the app available in the US app store, it is a good idea to provide some English documentation.
  3. I personally wrote to the developer a week ago. No response yet. There might be a language barrier. But it does not fill me with confidence about the support for the program.

So, what does one say about WonderPen?

I like it. It does give you a platform to write in. Expect to write all of the Markdown syntax yourself. The library function is well implemented. The security of the data is explicitly maintained and supported. The export options are adequate. The memo function for every document is a nice innovation. The program has promise with some caveats.

It has a light version available for you to try out the product. Here. You can take it out for a test drive.

WonderPen is recommended for those on a budget.

Update: I heard from the developer of WonderPen. He says that improvements are coming. I am excited about the future of this application.

macosxguru at the gmail thingie

macOS Writing WonderPen
February 12, 2018

Quick and Easy Scratch Pads

Product: Tyke
Price: Free

Product: Scrawl Product Link: Mac App Store Link
Price: Free

Product: Airnotes
Purchase Link: Mac App Store Link
Price: Free

Product: FiveNotes | Apptorium Purchase Link: Mac App Store Link Price: $4.99

During your work on the computer there are little things which you need to keep a record of. The expectation being that you are going to get to it a later stage. It is the quintessential sticky note solution. You have to keep a record of it, copy and paste it, accessible and available to you when you need it. These are programs trying to solve that problem for you.

I have written about this category of products before:

In this article I am going to cover four more.


Tyke IconTyke Icon

The developer of Tyke describes it as "A little bit of scratch paper that lives on your Mac menu bar." It is an apt description for a program which is focused on its single task: providing you a little window to type your note into. No preferences but one, and a strange one at that, you can enable/disable smart quotes, nothing else. This is the most basic of the four products I am going to describe in this article. It is free. It does what it sets out to do and is a treat to work in.

Tyke WindowTyke Window

This is recommended if you are looking for the most basic implementation of a note-taking window.


Scrawl IconScrawl Icon

Scrawl is a more complete product than Tyke. For one, it has an iOS counterpart, called Scrawl Notes. It has iCloud syncing built in and it has preferences. Okay, the preferences are minimal:

Scrawl PreferencesScrawl Preferences

It gives you the choice of where you want Scrawl to show up: menubar, dock or both. You can setup Scrawl to launch when you log in.

Like Tyke, Scrawl gives you a single window to type in.

Scrawl WindowScrawl Window

Focused on a single task, this is a well-designed application and the added benefit of syncing the contents of the singular note across your devices makes this useful.

Simple, elegant and useful. Scrawl is highly recommended if you want your note to be available on both your macOS and iOS devices.


Airnotes IconAirnotes Icon

Airnotes is another of these one document note-taking apps which reside on the menubar. Like Scrawl, it saves its documents in iCloud. The sync is waiting to be completed by the launch of the iOS version of the program.

Airnotes WindowAirnotes Window

Unlike any of the other options listed here, Airnotes lets you choose your own font from your list of installed fonts. This alone makes it makes it more usable to me.

Airnotes PreferencesAirnotes Preferences

The rest of the preferences are somewhat strange. You can post the content to Facebook. I have not tried this feature. You can copy a link to the product from the App Store from this preference pane. The link points to the Mac App Store.

Airnotes won me over with the ability to choose my own font, but besides that this is indistinguishable from any of the other offerings. Till it launches an iOS version, this is constrained by being a macOS only solution.

Airnotes works and is efficient. Recommended if you are currently looking for a macOS only solution and font choice is important to you.

Five Notes

Five Notes IconFive Notes Icon

Five Notes is the only commercial app in this round up. It is distinguished by giving you five note spaces instead of one.

Five Notes WindowFive Notes Window

Five Notes has some features which make it compelling:

  • Five Notes has the ability to manage five different notes. You switch between the notes with ⌘+(number of note).
  • Supports the share extension built in to macOS.
  • Supports the basic elements of Markdown, headers, bold and italic text, quotes and lists.
  • Unlike the others in this list, this implements a user selectable keyboard command to get to the editing window without having to tap icons on the menubar.

Five Notes PreferencesFive Notes Preferences

Five Notes has a set of preferences which make the product useful:

  • Five Notes doesn't give you the ability to use your own fonts but it does give you the ability to choose the size of the font display.
  • Lets the Five Notes window stay on top and display/hide its window at start.
  • Gives you the option of launching Five Notes on startup.

Five Notes is the most accomplished of the products in this collection. It is distinguished by its support of Markdown and its provision of five editing windows instead of the single one of its competitors.

If you are going to be using a scratchpad, and don't mind spending $4.99 for that task, Five Notes is the product I heartily recommend.

macosxguru at the gmail thingie

Tyke Scrawl Airnotes Five Notes writing