The old Workspaces feature is now called Layouts.

The old Layout settings page is now called Layout presets.

This keeps the distinction simpler:

• Layouts are your saved interface arrangements
• Layout presets are the built-in starting points you can apply to create a layout

Existing saved setups are migrated automatically, including the current layout, the previous layout, layout names, and layout selector shortcuts.

For scripting, the new hook name is layoutSwitchedHook(oldUuid, newUuid). Older scripts using workspaceSwitchedHook(oldUuid, newUuid) will still work for now, but they are deprecated and should be updated.

If you want to follow the discussion behind the rename, please take a look at GitHub issue #3564.

This relaunch is the result of the work done in #3414.

Why the Relaunch?

The QOwnNotes webpage has served our community well for years, but as web technologies have evolved. VuePress 1 has reached end of life and is no longer maintained, making this migration both necessary and timely.

What's New?

VuePress 2: The Next Generation

We've migrated from VuePress 1 to VuePress 2, which brings:

• Vite-powered bundling for lightning-fast build times and hot module replacement during development
• Improved plugin system with better extensibility and maintainability
• Enhanced markdown support with better syntax highlighting and extended features
• Better TypeScript support for more robust code
• Optimized production builds with improved code splitting and lazy loading

Vue.js 3: Modern Reactivity

The move to Vue.js 3 provides:

• Composition API for more flexible and reusable component logic
• Better performance with a faster virtual DOM and improved reactivity system
• Smaller bundle sizes through tree-shaking and optimized runtime
• TypeScript support built from the ground up
• Improved developer experience with better error messages and debugging tools

Vuetify 3: Material Design at Its Best

The integration of Vuetify 3 brings:

• Material Design 3 components for a modern, polished interface
• Improved accessibility with better ARIA support and keyboard navigation
• Responsive design that works seamlessly across all device sizes
• Customizable theme system with CSS variables for easy styling
• Enhanced component library with more features and better performance

Behind the Scenes

This relaunch involved:

• Migrating hundreds of markdown files to the new VuePress 2 format
• Rebuilding custom components with Vue.js 3's Composition API
• Integrating Vuetify 3 components throughout the site
• Updating all plugins to VuePress 2 compatible versions
• Implementing comprehensive end-to-end tests with Playwright
• Optimizing the build pipeline for faster deployments

The Tech Stack

Here's what powers the new webpage:

{
  "vuepress": "next (v2.x)",
  "vue": "^3.x (via VuePress 2)",
  "vuetify": "^3.7.4",
  "@vuepress/bundler-vite": "next",
  "@vuepress/plugin-docsearch": "next",
  "@vuepress/plugin-feed": "next",
  "@vuepress/plugin-seo": "next",
  "@vuepress/plugin-sitemap": "next"
}

The universal binary is available in the releases on GitHub as QOwnNotes.dmg and is replacing the previous Intel Qt5 build.

You need at least macOS 13 (Ventura) to run the new universal binary, the Qt5 legacy version will still be available as QOwnNotesQt5.dmg.

A known issue with Qt6 on Intel Macs is that the application might crash on exit when the logging panel was turned on.

Please visit the macOS installation page for more information.

Relations between notes can be created by linking to another note, for example with the Note link dialog.

The syntax for a note link is for example [My note](path/to/My%20note.md).

You can turn on the panel in the Window / Panels menu.

For more information visit the note relations page.

Feedback is welcome on GitHub issue #2074.

The OpenAI completion API was implemented to be used in scripts. This way you can do whatever you want and experiment with it.

• There is a new AI toolbar and a section in the Edit main menu, where can turn the service on, and you can select the AI backend and model
• You can add an OpenAI and Groq API key in the new AI settings
• Use the new script.aiComplete(prompt) scripting command to your own imagination
  • For more information please take a look at the Scripting documentation
• In the script repository, as a first step, there is a new script AI Autocompletion, that uses the selected AI model to autocomplete the current selection in the note text edit, and a new script AI Text Tool that uses the selected AI model to process the current selection in the note text edit, for example to summarize it, to translate it or to fix typos and grammar errors

The format of the source archive URL now looks like: https://github.com/pbek/QOwnNotes/releases/download/v23.7.0/qownnotes-23.7.0.tar.xz

Those cards are created in the stack you selected in the Nextcloud / ownCloud settings.

The tests will be run automatically when the QOwnNotes packages is updated in the Nix Store.

You can look or contribute to the tests at qownnotes.nix.

With the nixpkgs repository checked out you can run the tests easily isolated in a QEMU VM with the help of nix:

nix-build . -A nixosTests.qownnotes

Text is read via OCR from the screen and tested for validity.

# Remove Qt5 PPA in case you had it installed
sudo add-apt-repository --remove ppa:pbek/qownnotes

# Add Qt6 PPA
sudo add-apt-repository ppa:pbek/qownnotes-qt6

# Install QOwnNotes
sudo apt-get update
sudo apt-get install qownnotes

Also see: QOwnNotes Qt6 Preview in the installation guide.

If you find any issues please report them on QOwnNotes Issues on GitHub!

The image is property of Qt.

The Evernote importer was completely rewritten with stream support (QXMLStreamReader) to now support reading huge ENEX Evernote files (for #2711).

It also works under Qt 6 now to be more prepared for the future. A lot of effort is still going into porting QOwnNotes and the build and release process to Qt 6.

If you can please try to import large ENEX files and report how it went on #2711.

But still, even with the first release QOwnNotes did almost) everything I needed, being able to quickly create plain text file notes, the filename is generated from the first line of the note, notes are saved automatically.

• QOwnNotes webpage in Polish

If you want to help with the translation please visit the Translation documentation.

If I need a reference to another note I just do a note link to that note on the top of the note. I most of the times add a back-link in those notes too.

If a really need to have a 2nd note open, then I open the the note in a different window read-only (right click on the note in the note list).

If I quickly need to navigate between points in notes I use "bookmark" shortcuts (e.g. Ctrl + Shift + 1) and jump between passages that way (e.g. back with Ctrl + 1).

I don't use different instances of QOwnNotes.

This is a follow-up to a question on GitHub on my workflow with notes.

You can use notes with a special tag to store command snippets, which you can execute from the command-line snippet manager.

For more information on how to add commands and configuration please see Command-line Snippet Manager.

All versions will be loaded and shown in a dialog, you can show the difference between the current note and the past version or just view the full text of the past note.

Click Restore selected version to restore the selected past version of the note.

There you can open the image or attachment, open their parent folders, delete an image or an attachment file or add it to the current note. You can also only show orphaned images or attachments to re-add them to notes or remove them entirely.

In this example a note link [Welcome to QOwnNotes - Later](Welcome%20to%20QOwnNotes.md#Later) will be inserted into the note.

If you click the link you will jump to the heading Later of the Welcome to QOwnNotes note.

You will find more information in feature request #1977.

http://qownnotn3bknenanjs5u4nf3f2law2tzmqklux3c5e2xbvzcksmxm6yd.onion/

To reach it you can use the Tor Browser.

If you for example want a view where you can edit notes and one where you just can preview them you can create a new workspace with the name Preview.

Then you can turn off the panels you don't want in the Window / Panels menu.

You can also drag panels around by enabling Unlock panels in the Window menu.

Afterward you can switch between the workspaces in the workspaces dropdown.

All changes you make to the user interface (enabling and disabling panels, moving panels) are done to the current workspace. Switch to another workspace if you want to edit it.

Note links or links to media files like ![image title](media/my-image.jpg) can be opened the same way.

Feel free to follow it there if you are into the Fediverse.

https://social.qownnotes.org/@qownnotes

Visit the Debian installation guide for more information on how to use the repository.

The notebook / folder structure, tags, images, attachments and the meta data can also be automatically imported.

You can download QOwnNotes on the installation page.

The web application on your phone communicates with your QOwnNotes desktop application over the internet. The communication between QOwnNotes and the web service is transport encrypted.

There was a new settings page Web application to add support for the web application added in QOwnNotes 21.4.2.

Don't forget to copy your secret token from the QOwnNotes settings page to app.qownnotes.org to be able to communicate with your local instance of QOwnNotes.

You can find the source code of the web application at web-app on GitHub.

You can also host this web service yourself, the freshly built docker images are available at qownnotes-web-app on DockerHub.

The new web application is currently in alpha state and still "work in progress", feel free to test it and report what your think on the GitHub issues page!

• QOwnNotes webpage in French
• QOwnNotes webpage in Spanish
• QOwnNotes webpage in Hungarian
• QOwnNotes webpage in Persian

If you want to help with the translation please visit the Translation documentation.

You will also find a lot of related QOwnNotes tips on the page.

Additionally you can also access this new page from the Help menu in QOwnNotes starting with version 20.11.4.

Currently the German translation of the webpage is already online as "work in progress".

You all are kindly invited to help translate and proofread the German translation and if you want also help with the translation into other languages.

You can install it the usual way:

sudo add-apt-repository ppa:pbek/qownnotes
sudo apt-get update
sudo apt-get install qownnotes

Visit the installation page for more information on how to install the Fedora 33 release of QOwnNotes.

(image by getfedora.org)

There already was a legacy update service implemented for api.qownnotes.org, but the proxying to it didn't work properly.

Now there is a proper proxy in place that tunnels the old requests to the new "legacy api" so old versions of QOwnNotes should get update notifications again.

Maybe posting to the Facebook Page can also be handled by Beehive in the future. The "Facebook Hive" needs to be adapted for Facebook pages to allow this.

The Blog RSS Feed is part of the QOwnNotes webpage and the Release RSS Feed is part of api.qownnotes.org.

Check out the episode #35 -The Best Free Note Taking App -Interview with Patrizio Bekerle (Creator of QOwnNotes) if you want to listen to the interview.

Don't forget to update your installation of QOwnNotes as well!

For more information about the syntax of the bookmark links and everything else please visit the QOwnNotes Web Companion browser extension knowledge page entry.

It was completely rewritten with generator-web-extension, webextension-toolbox, webpack and VueJS.

Current features

• creating a new note (only text) from the current selection by right-clicking it
• creating a new note from the content of the current webpage by right-clicking on the page
  • the html will be converted to markdown and images of the page will be downloaded (might take a while)
• creating a new note with a screenshot of the visible part of the current webpage by right-clicking on the page
• there is a browser option page to set and reset the server socket port

Current features

• creating a new note (only text) from the current selection by right-clicking it
• creating a new note from the content of the current webpage by right-clicking on the page
  • the html will be converted to markdown and images of the page will be downloaded (might take a while)
• creating a new note with a screenshot of the visible part of the current webpage by right-clicking on the page

You can download the current release of the extension at QOwnNotes Chrome Web Companion 18.12.0, just drop the file into Chrome to install the extension.

Please head over to #330 to comment on the development process.

A lot has changed between the first release in end of 2014 and now over the course of 3593 commits. The changelog will tell you the (almost) whole story.

Thank you for your support in the last years!

Please test it and report back on #205.

Visit the installation page for more information on how to install the new releases.

(image by victorhckinthefreeworld)

Update: QOwnNotes was also mentioned in the mintCast epsisode 279 at minute 23:09.

What problem did you try to solve with QOwnNotes, why did you write it?

In late 2014 I needed a way to quickly take notes with one keyboard shortcut and the current date in the filename (until I have the time to change it to something better). The notes should be stored as simple text-files in a directory so I can sync them easily. The desktop-software needs to run on every popular operating system.

After trying out several text-editors I found none that could really do that in the way I liked it, so I wrote my own. 😃

I chose Qt and C++ as platform because as long-time KDE user I love the framework and always wanted to create a Qt application to "scratch my own itch".

Since then 405 new versions of QOwnNotes were released.

I cannot remember if I used ownCloud before or because I created QOwnNotes, but I loved ownCloud because it was FOSS and I could host it myself and as PHP-developer it also was a great fit for me. ownCloud notes met most of my requirements for note-taking in the web at that time.

Which three QOwnNotes scripts do you consider most useful?

• I love scripts to create new notes from text I copied from web-applications like Note from Jira issue and Note from Bitrix24 task
• others like the script @tag tagging in note text because with it they can store their tags inside the notes
• if you need to modify the way the user-interface looks you can do so with Custom user interface styling or Custom note preview styling if you want to do the same with the preview

What do you have to know to write a QOwnNotes script?

Scripts are written in JavaScript (inside QML files). There are a lot of examples on and you can always use the scripting repository at as reference for new scripts.

There is a documentation of all the API calls on .

You can use as many private and local scripts as you like and if you want make a script public you can create a pull-request on .

How secure is your encryption of the notes, what algorithm do you use?

Note encryption is by default done by the Botan library with AES-256.

You can also use your own encryption with the help of the scripting engine. There are already scripts for encrypting notes with PGP (PGP Encryption) or Keybase (Keybase Encryption).

I guess the main weak point of the encryption would be the password you are using to encrypt a note.

What data wouldn't you trust it with?

If you encrypt a note you loose the ability to find text in it with the note-search functionality, because the encrypted note-text is stored base64-encoded in the note text-file. The headline isn't encrypted.

Do you plan to include more Code highlighting?

Only for the preview if a fully fledged browser will be used for the preview somewhere in the future, which would have advantages (usage of JavaScript libraries in the preview, fewer html rendering errors) and disadvantages (bad backward compatibility, issues with printing/exporting, larger applications size, larger memory footprint, possibly slower rendering speed).

Visit the installation page for more information on how to install the Fedora 27 release of QOwnNotes.

Note: There is no debug build for Fedora 27, because OBS had problems building it.

(image by www.fosslinux.com)

You will find the article in the print magazine or here: Cloud-Notizen

You will find it here: QOwnNotesAPI Marketplace page

If you are interested in OwnBackup, the simple database backup solutions for your ownCloud or Nextcloud installation, you can also find it in the ownCloud Marketplace: OwnBackup Marketplace page

Visit the installation page for more information on how to install the new release.

(image by appimage.org)

Visit the installation page for more information on how to install the new releases.

(image by Softpedia News)

Furthermore as a developer you can now register settings variables in scripts. This allows you to let the user configure your script in the script settings.

A lot of new useful scripts were added to the script repository, which now can be configured with the script settings variables.

There are now scripts directly available to

• encrypt your notes with PGP or Keybase
• create notes from Jira issues or Bitrix24 tasks
• transform selected note text to Jira Code or BBCode
• show statistics about your note
• paste Latex code as image
• modify the styling of the user interface of the application or the styling of the note preview
• create journal or meeting notes
• insert a headline and a link to the GitHub issue from an url in the clipboard
• favorite notes

Feel free to add your own scripts to the script repository. You will find a guide on how to do so at the QOwnNotes script repository.

Visit the installation page for more information on how to install the Fedora 25 release of QOwnNotes.

The new documentation page you will find on docs.qownnotes.org. It currently mainly exists of the scripting documentation.
If you want to help writing documentation you can add reStrucuturedText files in the documentation folder on GitHub.

(image by fossbytes.com)

Please visit the QOwnNotes installation page for details on how to use it.

A big thank you to Joshua Strobl on ⚓ T1687 QOwnNotes for packaging QOwnNotes for the unstable repository of Solus.

Edit 2016-11-25: QOwnNotes is now in the Solus main repository.

(image by Solus Project)

In the update dialog you will see a new Update button. If you press it the application will quit after a confirmation and a script will be loaded to update to the latest version of QOwnNotes.

After the update QOwnNotes will be started again.

Please use the checkbox Fake old version number in the Debug options to trigger an update and click Check for updates in the Help main menu to test the update process and provide feedback.

Under macOS please use this issue for feedback: Issue #102

Under Windows please use this issue for feedback: Issue #376

• you can use the new scripting hook encryptionHook() do implement your own encryption
• there are examples to encrypt notes with Keybase.io (encryption-keybase.qml), PGP (encryption-pgp.qml) or do a trivial "encryption" with ROT13 (encryption-rot13.qml)
• you can disable the password dialog with script.encryptionDisablePassword()
• to start an external synchronous process you can usescript.startSynchronousProcess()
• to check on which platform the script is running you can use script.platformIsLinux(), script.platformIsOSX() and script.platformIsWindows()
• for more information on the new commands please take a look at the scripting documentation

(image by keybase.io)

To do so you have to select all your notes and right click on them in your Evernote desktop client. Now select export notes and store them to an enex file.
Then click Import / Import notes from Evernote in the QOwnNotes main menu and import the enex file.

Formattings like bold and italic will be converted to markdown, as are headlines and links. Images from your Evernote notes will be embedded in your QOwnNotes markdown notes.

You can download QOwnNotes on the installation page.

In portable mode

• the internal sqlite database and the settings will be stored inside a Data folder at the binary's location
• the settings will be stored in an ini file
• the note folders will be automatically stored relative to the Data folder so that the correct note folders will be loaded regardless where your QOwnNotes installation is currently located

It will be activated if you run QOwnNotes with the parameter --portable.

On Windows there is a QOwnNotesPortable.bat in your release path to start QOwnNotes in portable mode.

Note: QOwnNotesPortable.exe was dropped because of anti virus false positives.

Portable mode for USB sticks

Thank you, Lionel R. for your interventions!

(image by webupd8.org)

You can listen to the full episode here: Linux Voice Podcast - Season 4 Episode 10

Linux Voice is really a great magazine (I subscribed to it a few month ago) and it's all about free software and free speech. You can download all back issues (Creative Commons BY-SA license) for free at back issues.

(image by www.linuxvoice.com)

You can visit the QOwnNotes uApp Explorer page to get more information.

Please visit the QOwnNotes installation page for details on how to use it.

Snaps are working on many Linux distributions like Arch Linux, Debian, Fedora, Gentoo Linux and Ubuntu.

Also see what the Ubuntu Community Q&A has to say about QOwnNotes.

(image by snapcraft.io)

With friendly permission from Neil from Linux Format you can download the article here:

LXF213.hot.pdf 376.23 kB You can also buy the full issue: Buy Linux Format issue 213

Please visit the QOwnNotes installation page for details on how to use it.

(Slackware logo by www.unixstickers.com)

Review of QOwnNotes

Hi, I just wanted to leave some general feedback on QOwnNotes and why I think it's one of the best in its class:

I've been extensively researching Markdown editors with live preview and export to a formatted file such as PDF. One of the finalists is QOwnNotes:

• Can work completely offline with a folder on the local filesystem that contains .md files, no xCloud integration required.
• Automatic saves - a surprising number of similar tools require opening a document, and then saving changes before closing. If I wanted a workflow like that I would just use LibreOffice. But QOwnCloud simply saves all changes instantly, which allows me to quickly jot something down and then close it without worrying whether it was saved or not.
• Search - Surprisingly, even some of the very full-featured Markdown editors don't have search across multiple documents. QOwnNotes has instant search/filtering of document titles and their content too, and even allows regexp.
• Tag support - This is also a rare find in Markdown editors, and QOwnNotes even allows a tag hierarchy!
• List of documents - Again, if I wanted to have to open and navigate to a markdown file on my filesystem I would just use LibreOffice. But QOwnNotes has a master Notes directory, and right in the main interface it shows the available document names, and even allows switching between different folders for organization freaks like myself.
• • and * automatically appear with the key when working on outlines.
• Document navigator automatically creates an index based on your headings to navigate through long documents
• Allows exporting the formatted document to HTML or PDF for printing.
• Allows for linking to other document titles in QOwnNotes with note:///name-of-title
• NOT Electron based! Lightweight, fast, and properly packaged for most distros.

This is an extremely full-featured and well thought-out program. It definitely feels like a far better alternative to the likes of Haroopad. Thanks for creating it!

Footnote

You can see his original post at GitHub and another posting on Reddit.

Click at #qownnotes to open your IRC client or click on QOwnNotes Webchat for a web version.

By using the power of the QQmlEngine and QML files with JavaScript you are now able to script some new behavior into the application yourself.

You will find a new Scripting tab in the settings dialog, where you can add as many scripts to QOwnNotes as you like (you can also disable them temporarily).

Currently you may need to restart QOwnNotes to let changes in a script take action.

I prepared some examples and documentation to play around with.

If you need access to a certain functionality in QOwnNotes or have questions or ideas please open an issue on the QOwnNotes issue page.

Chris almost got all facts right, beside from that the QOwnNotes companion ownCloud app QOwnNotesAPI isn't needed for note syncing, but for accessing the note versions and trashed note on your ownCloud server. 😉

You can watch the part on YouTube at QOwnNotes at Linux Action Show 410.

You can get issue 25 of Linux Voice on their webpage.

Thanks a lot to Graham from Linux Voice to provide me with the article!

Now I know why lately more people are assuming that QOwnNotes is using the notes from OwnNote, which it doesn't. 😃

QOwnNotes uses the same text files as the ownCloud notes app.
OwnNote uses HTML in the database.

Please read Does QOwnNotes support ownNote for more information.

Please visit the QOwnNotes installation page for details on how to use it.

99 releases after the initial release QOwnNotes 1.0 is out now in 6 languages**,** with Freedesktop theme icons support and with software repositories for Ubuntu, Arch, openSUSE, Fedora and Debian Linux, as well as packages for OS X and **Windows**.

Thank you for all the support in the last 16 months!

If you want to get involved with QOwnNotes read: Getting involved

The repository also makes use of the wonderful openSUSE build service.

Please visit the QOwnNotes installation page for details on how to use it.

Please visit the QOwnNotes installation page for more details.

The repository uses the openSUSE build service.

Please visit the QOwnNotes installation page for details on how to use it.

It's name is QMarkdownTextEdit and you'll find it on QMarkdownTextEdit on GitHub.

Current features

• markdown highlighting
• clickable links with Ctrl + Click
• block indent with Tab and Shift + Tab
• duplicate text with Ctrl + Alt + Down
• searching of text with Ctrl + F
  • jump between search results with Up and Down
  • close search field with Escape

And if you don't want to miss every source code commit there is the QOwnNotes GitHub commit RSS feed.

Of course there also is the QOwnNotes blog RSS feed, if you want the latest news about the project.

For more convenience there are now software repositories for Ubuntu Linux, openSUSE Linux and Fedora Linux, done with Ubuntu Launchpad and the openSUSE build service.

You will not get any update notifications if you are using the software repositories, since your operating system is doing the updates, but you can always visit the changelog to see what happened.

Visit the new installation page for instructions on how to use them. There you will also find installation instructions for the other supported operating systems, like OS X and Windows and instructions on how you can build QOwnNotes yourself.

Furthermore, QOwnNotes got support for managing your ownCloud todo lists!

To manage your todo lists you need ownCloud tasks or Tasks++ as backend, with which you also can manage your todo lists in the web and on your mobile devices.

Please be encouraged to report any troubles, wishes or ideas you have on the QOwnNotes issues page!

You may also want to subscribe to the QOwnNotes RSS Feed to get the latest information about the project.

You can also watch the part directly where it starts on YouTube.

I'm using Travis CI for Ubuntu Linux, visit QOwnNotes on Travis CI.

GitLab CI is used for creating the macOS builds, visit QOwnNotes on GitLab CI.

And AppVeyor is used for creating the builds for Microsoft Windows, visit QOwnNotes on AppVeyor.

You will find all the new binaries in the download area of the project page.

Examples:
- <note://MyNote> opens the note "MyNote"
- <note://my-note-with-spaces-in-the-name> opens the note "My Note with spaces in the name"
- <http://www.bekerle.com/QOwnNotes> opens the webpage
- <file:///path/to/my/file/QOwnNotes.pdf> opens the file "/path/to/my/file/QOwnNotes.pdf" if the operating system supports that handler

You will find the new binaries in the download area of the project page.