Skip to content

Add steps to how setup Butterfly with Nextcloud in storage.md#1002

Open
JerryMerweather wants to merge 12 commits into
LinwoodDev:developfrom
JerryMerweather:patch-10
Open

Add steps to how setup Butterfly with Nextcloud in storage.md#1002
JerryMerweather wants to merge 12 commits into
LinwoodDev:developfrom
JerryMerweather:patch-10

Conversation

@JerryMerweather

@JerryMerweather JerryMerweather commented Dec 8, 2025

Copy link
Copy Markdown
Contributor

I am still not finished, not sure what else to include.

Please call copilot because this is a draft with slight editing.

  • Steps 4 Nextcloud
  • Add pictures
  • Explain more about webDAV for non-nextcloud setups

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR enhances the storage documentation by adding detailed step-by-step instructions for setting up Butterfly with Nextcloud via WebDAV. The change transforms a single-line reference link into a comprehensive guide with two sections: one for obtaining the WebDAV URL and another for generating app-specific credentials in Nextcloud.

Key changes:

  • Added detailed instructions for obtaining the WebDAV URL from Nextcloud (5 steps)
  • Added instructions for creating and using app-specific passwords for secure authentication (8 steps)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
JerryMerweather and others added 4 commits December 8, 2025 20:42
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@JerryMerweather

JerryMerweather commented Dec 8, 2025

Copy link
Copy Markdown
Contributor Author

That is amazing
As for images, I am having a hard time finding a markdown editor that could show me how my images will look.

I dont want to setup node.js

EDIT: I did anyway. also https://www.jotbird.com/ is good editor

will be deleted
i made the file to make this new dir, because github ide mode isnt working on firefox
@JerryMerweather

Copy link
Copy Markdown
Contributor Author

Yoo man, let that copilot do some checks.

@CodeDoctorDE

Copy link
Copy Markdown
Member

Copilot usage is so limited i can't do this anymore.
but here is chatgpt review:

Thanks for adding more detailed Nextcloud/WebDAV setup instructions. This is a useful improvement, but I think this should be cleaned up before merging.

A few things I noticed:

  • Please keep the existing explicit anchors: ## Remote storage {#remote} and ### Offline sync {#offline}. Removing them can break existing links to these sections.
  • The screenshots inside the numbered lists should probably be indented under their list items, otherwise the Markdown renderer may break/restart the ordered list.
  • The password/username section skips from step 5 to 7.
  • Name4.jpg seems to be added but unused, since the document references Name4.png.
  • The PR description still says this is unfinished. If this is still work-in-progress, it should probably be a draft PR; otherwise the checklist should be updated.

Also maybe rename the sections a bit more explicitly, for example:

#### Nextcloud: get the WebDAV URL
#### Nextcloud: create an app password

That would make it clearer that these exact steps are Nextcloud-specific, while the remote storage feature itself works with WebDAV in general.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 10 changed files in this pull request and generated 4 comments.

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. This folder can be changed in the settings.

## Remote storage {#remote}
## Remote storage
Comment on lines +46 to +54
#### How to get the URL
1. Go to 'Files'
![](@assets/img/webDAV/URLstep1.png)
2. Open the 'Files settings'
![](@assets/img/webDAV/URLstep2.png)
3. Choose the 'WebDAV' section in the sidebar, then Copy the URL
![](@assets/img/webDAV/URLstep3and4.png)
4. Paste the URL in the URL input box in Butterfly
![](@assets/img/webDAV/URLstep5.png)
Comment on lines +56 to +68
#### 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'
![](@assets/img/webDAV/Name1.png)
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'
![](@assets/img/webDAV/Name2.png)
7. After authenticating, copy the email and paste it in the username input box in Butterfly
![](@assets/img/webDAV/Name3.png)
8. Finally, copy the password and paste it in the password input box in Butterfly
![](@assets/img/webDAV/Name4.png)

It is a zip archive containing the information (mostly in JSON files) about the note.
These included JSON files aren't optimized for human readability.
These included JSON files aren't optimized to be readable by a human in its raw form.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

3 participants