You can store your notebooks on Dropbox or sync them with a directory on your device.
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.
Note that Orgzly doesn’t yet detect deletion of remote notebooks. If you delete a notebook in the repository it will be restored after sync (unless you deleted it in the app as well).
The Dropbox app is not required for syncing, instead you will allow Orgzly to contact Dropbox on your behalf using the browser.
- Go to
Settings - Click on
Sync - Click on
Repositories - Click on
Dropbox(if you already have some repositories, click the plus icon first) - Enter the directory inside Dropbox (without “Dropbox” part)
You can sync your notebooks over WebDAV with any service that supports it, such as Nextcloud, for example.
- Go to
Settings - Click on
Sync - Click on
Repositories - Click on
WebDAV(if you already have some repositories, click the plus icon first) - Enter the URL, username and password
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.
- Go to
Settings - Click on
Sync - Click on
Repositories - Click on
Directory(if you already have some repositories, click the plus icon first) - Click
Browseand select (or create new) directory
After 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:
- Notebook was created in Orgzly, but there is already a remote notebook with the same name in one of the repositories
- Multiple repositories are used and there is a notebook with the same name in them
Link is removed when:
- Repository is renamed or deleted
Link can be set manually:
- Open the list of notebooks (“Notebooks”)
- Long-click on a notebook
- Click on
Set Link - Choose a repository
- Click
Set
Link is set if you can see the URL next to the small link icon in notebook’s details.
See Notebook has no link and one or more remote notebooks with the same name exist.
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 Loadto import remote notebook and overwrite the local versionForce Saveto export local notebook and overwrite the remote version
These actions are available in notebook’s contextual menu:
- Open the list of notebooks (“Notebooks”)
- Long-click on a notebook to open the 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.
- By default, tags are separated from the title with a single space
character. You will lose your tags’ indentation as if you had
org-tags-columnset to0.- You can set
Tags columnin the app’s preferences (underSettings / Sync / Org file format / Tags indentation), which should behave just likeorg-tags-column. - There is also a preference to make
Tags columnoutput compatible withorg-indent-mode.
- You can set
- Unsupported metadata below header is part of note’s content. As soon as any unsupported metadata is encountered, lines from that point until the next heading are considered part of note’s content. You might find an unexpected new line between supported and unsupported metadata, because note’s content is normally separated from heading by a new line.
If any of this is not working for you, please contact us.
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:[email protected]
You can dial a phone number, compose SMS or MMS.
tel:1-800-555-0199voicemail:1-800-555-0199sms:1-800-555-0199sms:1-800-555-0199?body=omw%20brtsmsto:1-800-555-0199mms:1-800-555-0199mmsto:1-800-555-0199
To open a map you can specify the exact location or a search query.
geo:40.7128,-74.0060geo:0,0?q=new+york+citygeo: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.txtfile: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(orno) – matches notes without the property
OP can be:
eq– equal toTIMEne– not equal toTIMElt– less thanTIMEle– less than or equal toTIMEgt– greater thanTIMEge– greater than or equal toTIME
If OP is not specified:
- Default value for
s,dandcrisle - Default value for
ciseq
TIME can be:
Nh–Nhours from nowNd–Ndays from nowNw–Nweeks from nowNm–Nmonths from nowNy–Nyears 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,tmrwortomtodayortodnowyesterday
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 forTODOnotes which are tagged withjohnb.Work .i.done- Search in notebookWorkfor notes withoutDONEstate(b.Home or b.Work) phone- Search in notebooksHomeandWorkfor notes which contain the stringphonein their title, content or any of the tagss.1d p.a- Search for priorityAnotes scheduled for tomorrow or earlier (same asp.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 priorityB(includes notes with no priority if default priority isB)ps.b- Search for notes with priority set toB
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, source code is available on GitHub.
Orgzly is also available on F-Droid. Or you can download APK files directly from 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.
After implementing some of the important features which are still missing in the current Android version, there is an idea to start working on either iOS version or a Web application.
See Privacy Policy.
Email us at [email protected] and visit Orgzly.com.
Follow us on Twitter and Facebook.
Help us localize Orgzly by joining our Crowdin project.