1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
*****************************
grauphel - tomboy REST server
*****************************
ownCloud__ application implementing the `Tomboy`__ `REST API`__ for syncing notes.
Work in progress.
__ http://owncloud.org/
__ https://wiki.gnome.org/Apps/Tomboy
__ https://wiki.gnome.org/Apps/Tomboy/Synchronization/REST/1.0
======
Status
======
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 :-)
=================
Supported clients
=================
* Conboy__ (Nokia N900 Maemo)
* Tomboy__ (Linux, Windows)
* Tomdroid__ (Android)
__ http://conboy.garage.maemo.org/
__ https://wiki.gnome.org/Apps/Tomboy
__ https://launchpad.net/tomdroid
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
=============
Functionality
=============
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"
============
Dependencies
============
* PHP
* PHP `oauth extension`__
__ http://pecl.php.net/package/oauth
============
Installation
============
Manual installation
===================
#. SSH onto your web server
#. Navigate to the owncloud ``apps`` directory, often in ``/var/www/owncloud/apps``
#. Download the latest release from http://cweiske.de/grauphel.htm and extract it.
For example::
$ wget http://cweiske.de/download/grauphel/grauphel-0.5.0.tar.bz2
$ tar xjvf grauphel-0.5.0.tar.bz2
$ rm grauphel-0.5.0.tar.bz2
You do have a directory ``/var/www/owncloud/apps/grauphel`` now.
#. Using your browser, login as administrator into ownCloud and click
the "Apps" icon in the main menu ("+" icon).
#. Click on "Grauphel: Tomboy note server" and then on the "Enable" button.
#. 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, do the following::
$ apt-get install php5-oauth
$ /etc/init.d/apache2 restart
Reload the ownCloud page in your browser now.
======
Author
======
Christian Weiske, cweiske@cweiske.de, http://cweiske.de/
=====
Links
=====
- `Homepage`__
- `grauphel on apps.owncloud.com`__
- `Source code repository`__
- `Github source code mirror`__
__ http://cweiske.de/grauphel.htm
__ http://apps.owncloud.com/content/show.php?action=content&content=166654
__ http://git.cweiske.de/grauphel.git/
__ https://github.com/cweiske/grauphel
=================
Development hints
=================
* 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.
|
