Skip to content

Tomboy note synchronization REST server nextcloud app


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

grauphel - tomboy REST server

nextCloud application implementing the Tomboy REST API for syncing notes.

Pretty stable.

I have taken over the repository.

Please submit requests/bugs via the [GitHub issue tracker]( A Matrix Room exists also at :

  • Note synchronization
  • OAuth token management interface
  • Database management interface (reset)
  • Viewing notes
  • Searching notes
  • Downloading notes as HTML and reStructuredText
  • Web interface to edit notes. I will probably not implement this. Patches welcome :-)

grauphel 1.0.0 is known to work with:

  • Tomboy 1.15.2, Linux
  • Tomboy 1.15.1, Windows
  • Tomdroid 0.7.5, Android 4.4.1

See the HowTo document for client-specific configuration instructions.

You can use nextCloud's global search on the top right.

During search, the note's titles, tags and content are searched.

Search syntax:

Search for notes containing "foo"
foo bar
Search for notes containing "foo" and "bar"
"foo bar" baz
Search for notes containing "foo bar" and "baz"
foo -bar
Search for notes containing "foo" but not "bar"


grauphel needs to be activated for all users. It will not work with the "enable only for specific groups" setting.

  1. Log into nextcloud as administrator
  2. Goto "Apps"
  3. Enable experimental apps in the settings
  4. Click "Productivity"
  5. Look for "grauphel - Tomboy sync server"
  6. Click "Activate"
  1. SSH onto your web server

  2. Navigate to the nextcloud apps directory, often in /var/www/nextcloud/apps

  3. Download the latest release from and extract it. For example:

    $ wget -O grauphel-1.0.0.tar.gz
    $ tar xjvf grauphel-1.0.0.tar.gz
    $ rm grauphel-1.0.0.tar.gz

    You do have a directory /var/www/nextcloud/apps/grauphel now.

  4. Using your browser, login as administrator into nextCloud and click the "Apps" icon in the main menu ("+" icon).

  5. Click on "Grauphel: Tomboy note server" and then on the "Enable" button.

  6. In the main menu, click the "Tomboy notes" icon.

It may be that grauphel now shows you an error message:

PHP extension "oauth" is required

You have to install the PHP PECL oauth extension now. On Debian 9 or higher, do the following:

$ apt install php-oauth
$ phpenmod oauth
$ /etc/init.d/apache2 restart

Reload the nextCloud page in your browser now.


oauth-1.2.3 is only needed on PHP 5.x For PHP 7 simply use pecl install oauth.

See for all released versions.

Joan Moreau,

Christian Weiske,,

  • JSON coming from Tomboy: Title is html-escaped already (e.g. > is >). We store it that way in the database, so there is no need to escape the output.
  • latest-sync-revision sent from Tomboy during PUT sync is already incremented by 1.
  1. Validate appinfo/info.xml:

    $ xmllint --noout --schema tools/info.xsd appinfo/info.xml
  2. Validate appinfo/database.xml:

    $ xmllint --noout --schema tools/database.xsd appinfo/database.xml
  3. Fill the ChangeLog file with the changes since the last release, mention the new version number.

  4. Update README.rst and increase the version number

  5. Create the grauphel release file with:

    $ phing

    The file will be in dist/