What works

• Note synchronization
• OAuth token management interface
• Database management interface (reset)
• Viewing notes
• Searching notes
• Downloading notes as HTML and reStructuredText

What is missing

• Web interface to edit notes. I will probably not implement this. Patches welcome :-)

Known working versions

grauphel 0.2.1 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.

Search

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

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

Search syntax:

foo

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"

App store installation

1. Log into owncloud 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"

Manual installation

1. SSH onto your web server

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

3. Download the latest release from http://cweiske.de/grauphel.htm#download and extract it. For example:

   $ wget http://cweiske.de/download/grauphel/grauphel-0.6.2.tar.bz2
   $ tar xjvf grauphel-0.6.2.tar.bz2
   $ rm grauphel-0.6.2.tar.bz2
   

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

4. Using your browser, login as administrator into ownCloud 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 7, do the following:

$ apt-get install libpcre3-dev php-pear php5-dev
$ pecl install oauth-1.2.3
$ echo 'extension=oauth.so' > /etc/php5/conf.d/oauth.ini
$ /etc/init.d/apache2 restart

Reload the ownCloud page in your browser now.

Unit testing

• ownCloud unit testing documentation

• grauphel on Travis CI

Releasing grauphel

To release a new version, do the following:

1. Increase version number in appinfo/version and appinfo/info.xml.

2. Fill the ChangeLog file with the changes since the last release, mention the new version number.

3. Update README.rst and increase the version number

4. Create the grauphel release file with:

   $ phing
   

   The file will be in dist/

5. Test the release on a server

6. Tag the release in git

7. Upload the release to http://cweiske.de/grauphel.htm with:

   $ phing update-website
   

8. Link the new release on https://apps.owncloud.com/content/show.php?content=166654