Installation | Changelog | Issues | Releases | Documentation | IRC Chat | Gitter Chat

Here you will find the scripts you can directly access in QOwnNotes, the plain-text file notepad with markdown support and Nextcloud and ownCloud integration.

Please visit the Scripting documentation for more information about scripting and how to write your own.

To bring your script into the script repository you just have to do the following:

• fork the repository https://github.com/qownnotes/scripts on GitHub
• checkout your forked repository with git clone https://github.com/YOUR_GITHUB_NAME/scripts.git qownnotes-scripts
• duplicate the example-script folder and give it a more descriptive name
• add your script to the folder and remove the example-script.qml
• edit the info.json to add your meta data and describe what your script is doing
  • you can use example script info.json to help you with the json encoding
  • if you are not sure which minAppVersion the commands you are using needs take the current version of QOwnNotes
• add a CHANGELOG.md with an initial release entry matching the version in info.json
• commit and push your changes to your repository
• create a pull request to get your script merged into the QOwnNotes script repository

When editing an existing script in the GitHub web interface, do the following:

• If you do not already have a fork:
  • Go to https://github.com/qownnotes/scripts.
  • Click the Fork button in the upper right of the screen (between Watch and Star).
  • Leave the defaults (recommended) and click the Create Fork button.
• In your fork, select the QML file to edit.
  • Make any desired changes.
  • Fill out the Commit changes fields.
  • If this is a personal fork, select 'Commit directly to main branch'.
  • Click Commit changes button.
• Select the associated info.json (it will be in the same folder).
  • Add your name as an author.
  • Increase the version number.
  • Ensure the minAppVersion reflects the correct version needed (if using new features).
  • Make any other changes.
  • Fill out the Commit changes fields.
  • If this is a personal fork, select 'Commit directly to main branch'.
  • Click Commit changes button.
• Add an entry for the new version to the script's CHANGELOG.md, creating the file if it does not exist.
• Create a pull request to qownnotes/scripts on the main branch.