Skip to content

Introduction

Banner


Welcome to Butterfly, the open-source note app.

Butterfly is a note-taking app that aims for a unified experience across all platforms. It provides a simple UI with powerful customization.

You can use the sidebar to navigate quickly through this wiki.

To start working on the app, you have two options:

  1. Download the app version that is appropriate for your platform. Butterfly can run on most mobile, desktop, and web platforms.
  2. Use the web version if you cannot find your platform or if you don’t want to install the app. See here for information about file storage on the web version.

Once you open the app, continue reading.

Welcome screen The top of the screen holds the update banner, a link to this documentation, and the Settings button. Finally, to the right of the Settings button, you have a drop-down menu for controlling when the update banner will appear (always/never/on updates).

The Files section is the main area to the left. Here, you can do the following operations:

  • Select the display type ( Grid or List)
  • Select the source storage of the files
  • Sort the display order of the files
  • Add a folder, file, template, or import files by clicking the plus sign
  • Switch to a different directory by typing in the Location field
  • Search for files

Finally, to the right, you have the Quickstart display with the templates available in the current location. For a fresh install, this includes the Light and Dark templates.

Once you open a document by selecting a template or an existing file, you will get to the Document View.

Document View

You can return from the document view to the document list with the back action of your device. As with the home view, the document display changes based on your device.

In the top-left of the screen, you have the file bar:
file_bar

This holds, from left to right:

  • The logo Butterfly button, which opens the menu.
  • The Name field, which displays the name of the note. You can rename the note by typing a new name into the field and saving the note.
  • The Save button. You can enable auto-saving and optionally disable this button by going to Settings → Behaviors → Autosave.
  • The Search button, which allow you to search for elements within the note.

In the top-right of the screen, you have the toolbar:
toolbar

By default, this bar has:

Then you have the button to add elements to the tool bar, the button to configure the document, and finally the tool to lock the zoom and/or the position of the screen. If some of the elements on the toolbar are not visible to you, click and drag (or swipe) left or right to reveal further tools.

To add more tools to the toolbar, click the Add button. In the Add menu, you can use the search bar or filters to find the tool you are looking for. For more information, see Add.

To reorder the tools on your toolbar, first select a tool and then click-and-drag it to a new position. Some input methods have shortcuts to quickly switch to tools based on their position on the toolbar, which can be configured.

Many tools have a configuration menu, which allows you to change settings about how the tool behaves. To open this menu, first select a tool in the toolbar and then click it again.