A bit of Everything
You can sync your notebooks with a directory on your device, or with a few different repository types: Dropbox, WebDAV, and (experimental) Git.
Notebooks are written as plain text files in Org mode file format.
Synchronization is currently manual – you have to initiate it
yourself by clicking the Sync
button. Button is located in the
navigation drawer.
The Dropbox app is not required for syncing, instead you will allow Orgzly to contact Dropbox on your behalf using the browser.
Settings
Sync
Repositories
Dropbox
(if you already have some repositories, click the plus icon first)You can sync your notebooks over WebDAV with any service that supports it, such as Nextcloud, for example.
Settings
Sync
Repositories
WebDAV
(if you already have some repositories, click the plus icon first)Optionally, if the server is using a self-signed certificate for example, you could add it here.
Notebooks can be synced with one or more directories on your device.
Settings
Sync
Repositories
Directory
(if you already have some repositories, click the plus icon first)Browse
and select (or create new) directoryAfter syncing is done, every notebook will have its sync status message updated.
Notebook is already synced. Nothing to do.
Notebook has been successfully synced by being saved to the repository represented by URL.
Notebook has been successfully synced by being loaded from the notebook represented by URL.
Orgzly doesn't know which remote notebook to use for syncing.
Each notebook must have a link to a remote notebook. Link is usually set automatically after the first sync. However, there are cases when this is not possible, or when the link is removed.
Link cannot be created after the first sync if:
Link is removed when:
Link can be set manually:
Set Link
Set
Link is set if you can see the URL next to the small link icon in notebook's details.
If you modify a notebook in Orgzly and at the same time (before performing a sync) you modify its linked remote notebook, next sync will leave the notebook in a conflicted state.
When notebook is not synced due to conflict, you have two options:
Force Load
to import remote notebook and overwrite the local versionForce Save
to export local notebook and overwrite the remote versionThese actions are available in notebook's contextual menu:
There is currently no other way to resolve a conflict within Orgzly itself.
When the local and remote notebooks have been modified in a Dropbox repository you can take advantage of the facts that Orgzly stores information in text files (in the Org file format) and that Orgzly will create a new copy of the file if you remove it from Dropbox.
For example, you might move the original, underlying .org file in Dropbox to a different directory, then tell Orgzly to sync the files again (which will cause Orgzly to create a new file (with the same file name)). You can then use an external tool (such as a diff program) to compare your original file and the file that Orgzly created. You can then determine what changes were made, and which ones you wish to keep.
Be sure to remember that the new file (the one created by Orgzly) is where you want to put your final, merged version of the file.
Notebooks are encoded in Org mode file format.
When compared to your original Org files, files generated by Orgzly might differ in the amount of white space, outlined below. Any other difference would be considered a serious bug.
org-tags-column
set to 0
.
Tags column
in the app's preferences (under
Settings / Sync / Org file format / Tags indentation
), which
should behave just like org-tags-column
.Tags column
output compatible
with org-indent-mode
.If any of this is not working for you, please contact us.
(Supported on Android 8 and above.)
For users who have a large number of .org files in their repository, and only
want Orgzly to load some of them, a .orgzlyignore
file can be
added to the repository on a remote device. The file uses the same syntax as
Git's .gitignore
file, which lets you exclude or include files
based on glob patterns. See the Git documentation
for details on the syntax. If the repository contains a
.orgzlyignore
file, it will be consulted in the following
situations:
Please note that the .orgzlyignore
file is not consulted each time
a notebook is saved to a repository, for performance reasons.
If the ignore rules are updated such that an existing Orgzly notebook suddenly matches an ignore rule, upon the next sync occasion, Orgzly will react as if the file has been deleted from the repository. This means that the notebook's repository link is removed, and a warning message is shown, but the notebook is not deleted from Orgzly. However, you will not be able to link the notebook to the same repository, unless you rename it to something which does not match an ignore rule. (It would also be possible to link the notebook to a different repository, with different or no ignore rules.)
Links can be used in note's title or content. Links can be enclosed in
brackets (e.g. [[link]]
). You can specify a name which will be displayed
instead of the link (e.g. [[link][name]]
).
https://www.orgzly.com
mailto:support@orgzly.com
You can dial a phone number, compose SMS or MMS.
tel:1-800-555-0199
voicemail:1-800-555-0199
sms:1-800-555-0199
sms:1-800-555-0199?body=omw%20brt
smsto:1-800-555-0199
mms:1-800-555-0199
mmsto:1-800-555-0199
To open a map you can specify the exact location or a search query.
geo:40.7128,-74.0060
geo:0,0?q=new+york+city
geo:40.7128,-74.0060?z=11
Links to external files are supported.
Files are relative to the main storage directory (e.g. /sdcard
).
file:Download/document.txt
file:Music/song.mp3
In Settings, you can change the relative root to point to any directory on your
device. There is one setting to set the root for absolute links (e.g. file:/readme.txt
),
and another setting to set the root for relative links (e.g. file:readme.txt
).
Linking to notes is done using properties. Two properties are supported – ID
and
CUSTOM_ID
.
If you set note's property ID
to
123e4567-e89b-12d3-a456-426655440000
you can link to the note using:
id:123e4567-e89b-12d3-a456-426655440000
Value can be anything, but UUID is recommended.
If you prefer a more user-friendly value, use CUSTOM_ID
property. This type of link starts with #
character, followed by the
property value. It must be enclosed in brackets. If you set
CUSTOM_ID
to Meeting checklist
, linking to that note is done
using:
[[#Meeting checklist]]
Link to a notebook within the app looks like a link to an external file:
file:gtd.org
Only the name matters and it has to be the same as the notebook you are linking to.
Search expressions are separated with space.
They are implicitly joined by logical AND
. OR
operator is also
supported. Both operators are case insensitive. AND
has higher
precedence than OR
.
Following search expressions are supported.
Some of them support .
(NOT) operator (see the last column).
Expression | Finds notes | Example | . |
---|---|---|---|
s.PERIOD |
Scheduled within period | s.today |
N |
d.PERIOD |
Deadline within period | d.le.2d |
N |
e.PERIOD |
Event within period | e.ge.now |
N |
c.PERIOD |
Closed within period | c.yesterday |
N |
cr.PERIOD |
Created within period | cr.ge.yesterday |
N |
i.STATE |
With state | i.todo |
Y |
it.STATE-TYPE |
With state type | .it.done |
Y |
b.NOTEBOOK |
From notebook | .b.Work |
Y |
t.TAG |
With tag (inherited too) | t.errand |
Y |
tn.TAG |
With tag (note's only) | tn.toRead |
Y |
p.PRIORITY |
Having priority | .p.c |
Y |
ps.PRIORITY |
Having set priority | ps.b |
Y |
PERIOD
can be:
OP.TIME
– matches timenone
(or no
) – matches notes without the property
OP
can be:
eq
– equal to TIME
ne
– not equal to TIME
lt
– less than TIME
le
– less than or equal to TIME
gt
– greater than TIME
ge
– greater than or equal to TIME
If OP
is not specified:
s
, d
and cr
is le
c
is eq
TIME
can be:
Nh
– N
hours from nowNd
– N
days from nowNw
– N
weeks from nowNm
– N
months from nowNy
– N
years from now
N
can be negative.
For example:
-2h
– two hours ago5d
– five days from today-2w
– two weeks ago3m
– three months from today1y
– one year from today
Few aliases for TIME
are available:
tomorrow
, tmrw
or tom
today
or tod
now
yesterday
STATE
is a keyword like TODO
, DONE
, NEW
, etc. Keywords are
case insensitive. Only states specified in Settings can be searched
by. Any keywords not included in the settings are not treated as
states - they become part of note's title.
STATE-TYPE
can be todo
, done
or none
.
NOTEBOOK
is the name of notebook. It must be surrounded with double
quotes if it contains spaces.
TAG
is searched as a substring. For example t.bee
will find notes
which are tagged with beeblebrox
.
PRIORITY
is a priority starting from A
.
Default ordering of notes is by notebook name then priority. If s
or
d
are used in the query, they are also sorted by scheduled or
deadline time. They are always sorted by position in the notebook
last.
You can change this behavior by using o
operator.
Using o.PROPERTY
will sort notes by property. .o.PROPERTY
is also
supported which sorts notes by property in reverse order. You can
specify multiple operators and they will be used in order.
Following properties are supported:
Property | Order by |
---|---|
b book notebook |
Notebook name |
t title |
Title |
s sched scheduled |
Scheduled time |
d dead deadline |
Deadline time |
e event |
Event time |
c close closed |
Closed time |
cr created |
Created-at time |
p pri prio priority |
Priority |
st state |
States as defined in Settings |
When a note contains multiple events, only one of those events is
considered when sorting. With o.event
the oldest event is used. With
.o.event
most recent event is used.
You can add ad.DAYS
to any query to display search results grouped by day.
DAYS
is a number of days you want to display.
For example, (t.gym or t.class) ad.3
will display notes tagged with
gym
or class
with any type of time set within next 3 days.
i.todo t.john
- Search for TODO
notes which are tagged with john
b.Work .i.done
- Search in notebook Work
for notes without DONE
state(b.Home or b.Work) phone
- Search in notebooks Home
and Work
for notes which contain the string phone
in their title, content or any of the tagss.1d p.a
- Search for priority A
notes scheduled for tomorrow or earlier (same as p.a s.tom
)s.ge.today o.book o.pri
- Search for notes scheduled for today or later, sorting them by notebook name then priorityo.book o.pri o.s
- Sort by notebook name then priority then scheduled timep.b
- Search for notes with priority B
(includes notes with no priority if default priority is B
)ps.b
- Search for notes with priority set to B
For each note you can tap on it to edit the note immediately. For
each note you can also swipe right to display a menu of options that
allow you to assign a starting time, cycle through the TODO
and
DONE
states, or to simply mark the note as DONE
. If you swipe
left you'll be given a single option: displaying the note in the
notebook that contains it.
Orgzly is free.
Yes, the source code is available on GitHub.
Orgzly Revived is also available on F-Droid. Or you can download APK files directly from the GitHub releases page.
Are you using F-Droid version? Dropbox is only available in Google Play's version of the app.
No, only Android version is available at the moment.
See Privacy Policy.
Email us at support@orgzlyrevived.com and visit Orgzlyrevived.com.
Help us localize Orgzly by joining our Crowdin project.