ストレージ

There are multiple ways of storing notes in Butterfly. Either by using your device storage, or by using the cloud storage (WebDAV).

Data directory

The data directory is the directory where documents, templates, and packs are stored. On desktop you can find it in ~/Documents/Linwood/Butterfly. モバイルでは、 getExternalFilesDir(null)/Linwood/Butterfly にあります。 Data の設定で変更することもできます。

このディレクトリには、Documents、Templates、Packsフォルダがあります。

Web

アプリケーションデータはブラウザに保存されます。 ローカルストレージに保存されます。 ブラウザで開発者ツールを開くと、データが表示されます。

ネイティブプラットフォーム

By default, the application saves the data in your documents folder in a subfolder called “Linwood/Butterfly”. This folder is created when you save data for the first time. このフォルダは設定で変更できます。

リモートストレージ

ノート

この機能はウェブ上では利用できません。

The application data can be stored on a remote server. これは、データを他の人と共有したい場合や、複数のコンピュータをお持ちの場合に便利です。 現在 WebDAV プロトコルのみがサポートされています。

リモートサーバーを追加するには、設定に移動して Remotes をクリックします。 Add remote をクリックします。 リモートサーバーの URL とユーザー名とパスワードを追加します。 その後、データが格納されているフォルダを指定できます。

To get the WebDAV URL, please visit the documentation:

Nextcloud (it should look like this: https://nextcloud.example.com/remote.php/dav/files/username/, replace username and nextcloud.example.com with the correct values)

Instructions for NextCloud

How to get the URL

1. Go to Files
2. Press the button on the bottom of the sidebar Files settings
3. Scroll down to the WebDAV section, then copy the full URL shown inside
4. Switch to Butterfly, and paste the URL in the URL input box in Butterfly

How to get the password and username

1. Go to your Nextcloud account info by pressing the profile picture on the corner
2. Then, press Settings
3. In the Security tab, scroll down to Devices & sessions
4. Enter any name for the app name input box
   • “Butterfly Connection” is a good name to use, as it is identifiable and clear.
5. Press the button called Create new app password
6. After authenticating, copy the app password username shown on the page, and paste it in the username input box in Butterfly
7. Finally, copy the password and paste it in the password input box in Butterfly

Finalizing the connection setup

After doing the above, press the Connect button.

If you have done everything correctly, there will be some new stuff down the popup.

Type the name of this connection in the Name inputbox, you can name it anything.

Then, for the Directory inputbox, you need to type where should Butterfly store stuff inside this cloud storage.

For example: if you type ButterflyDocs for Directory, Butterfly will store all your files inside the ButterflyDocs folder in your cloud storage.

ノート

• Avoid symbols in folder names (to be safe)
• Butterfly will create the folder if it doesnt exist

Lastly, after typing the name of the folder you want Butterfly to store your notes in, press Create.

That’s it. Syncing to the cloud should work now. 🎉

オフライン同期

この機能を使用すると、オフライン中にリモートサーバー上のファイルを編集できます。 ファイルまたはフォルダのポップアップメニューを開き、Syncをクリックします。 ファイルまたはフォルダをダウンロードし、ローカルに保存します。 ルートディレクトリ全体を同期する 作成ダイアログでチェックマークをクリックするか、設定内のリモコンをクリックし、管理セクションのチェックマークをクリックします。

いくつかの制限があります。

• オフライン中はファイルやフォルダを削除できません。
• オフライン中はテンプレートの追加、編集、削除はできません。

その他のストレージ方法

ネイティブデバイスを使用している場合は、お気に入りのプラットフォームとアプリケーションディレクトリを同期することもできます。 Google Drive has an official app on Windows and there are unofficial ones on the Play Store. On Linux you can also use the native remote storage system and change your data directory to this or add a new external storage if you click on the add connection button.

Supported file types

Butterfly supports importing SVG, Butterfly Note (.bfly), Butterfly Raw Note (.tbfly).

Butterfly Note (.bfly)

This file type is the recommended format for saving notes.

It is a zip archive containing the information (mostly in JSON files) about the note. These included JSON files aren’t optimized to be readable by a human in its raw form.

Butterfly Raw Note (.tbfly)

This file is recommended for use with version control software like git.

This file is not a zip archive; instead it is a JSON file. It contains all the information about the note in a single JSON file that is optimized for being readable and nicely formatted. It is slower to load than the normal Butterfly Note.

SVG

This file type doesn’t save information about the note! When this file is imported into Butterfly, it is treated as a single image.

Use this ONLY when the note shouldn’t be modified by Butterfly.