xenodium.com

Plain Org for iOS

https://plainorg.github.io/download-on-app-store.png

Bring org to your iPhone


built with 💙 by me - powered by org 🦄


Why?

Org mode on Emacs is wonderful. I'm a big fan and use it regularly on my laptop. As an iPhone user, I wanted quick access to my org files while on the go... so I built Plain Org for iOS.

News

Features

Org is a rich markup language, so please check if your favorite feature is supported (it may not be):

Feature requests / Bugs

Please file bugs or feature requests on GitHub.

What is org?

Org is a powerful plain text markup similar to markdown. It supports a wide range of features and is compatible with any text editor (Emacs, Vim, VSCode, etc.).

Sample Org Snippet

#+TITLE: My iPhone stuff

* Inbox
** DONE [#A] Publish Plain Org to App Store   :plainorg:
** NEXT [#B] Make [[https://xenodium.com/oatmeal-cookie-recipe][oatmeal cookies]] :cooking:

[[file:oats.jpg]]

** TODO [#A] Document unicorn sighting        :research:truth:
- [X] Talk to eyewitness.
- [X] /Flesh/ _out_ ~evidence~ =table=

| last seen | location       | country  |
|-----------+----------------+----------|
|     2017  | The Royal Mint | Scotland |
|     1991  | Harz Mountains | Germany  |


Syncing your data

Plain Org uses iOS File Provider extensions and relies on third parties to do the actual syncing. If your favorite cloud service offers an iOS extension, Plain Org can likely open, edit, and sync your data.

Your mileage may vary creating new files or opening local links. These may not be possible using your provider's extension.

Cloud Provider Support Table

View file    Edit file    New file    Open local links   
Dropbox
iCloud
Google Drive
Syncthing / Möbius Sync  
Working Copy / Git


Enabling Sync

See iOS's using third-party apps in Files to enable syncing data with your cloud service.

Plain Org is a paid app. At present, it is not FOSS. This may change in the future, but it is not something I can currently offer. I understand this may not be ideal for all, but hope there's partial relief in implementing a well-known text markup (ie. no vendor lock-in). Please help support its development if you can. Ping me if you need a free copy. Email me at "plainorg" + "@" + "xenodium.com".

FAQ

Can I use custom keywords?

Yes. Plain Org recognizes per-file keywords. That is, in the org file itself, you can specify both active and inactive keywords. You can the following to an existing org file:

#+TODO: TODO STARTED BLOCKED | DONE CANCELLED

Note: Keywords on the left hand side of the "|" are considered active while those on the right are inactive.

How do I sync my org files?

Depends on provider. See Syncing your data.

https://plainorg.com
http://plainorg.com
[[https://plainorg.com][Plain Org]]

To resolve id links, Plain Org needs granted access to a directory. When an id link is opened, the app searches the owning directory for other org files that may contain the id that's linked to. The following snippet shows a sample snippet:

Note: Not all syncing providers support granting access to a directory. Without this, Plain Org is unable to resolve id links.

Documents/bar.org
:PROPERTIES:
:ID: 90daa47c-3d6b-4d94-bf78-18d776c431c1
:CREATED: [2021-09-28 Tue 09:02]
:END:
#+TITLE: Bar

* TODO Review [[id:e4453d79-227f-4a78-bf04-9bdff5e4675f][Foo]]
Documents/foo.org
:PROPERTIES:
:ID: e4453d79-227f-4a78-bf04-9bdff5e4675f
:CREATED: [2021-09-28 Tue 09:02]
:END:
#+TITLE: Foo

* Some heading
* Another heading

To resolve file links, Plain Org needs granted access to a directory. When an file link is opened, the app tries to access the referenced file within the owning directory. If the linked file is an image and is accessible, Plain Org renders it inline. For others, like pdfs, they are opened in a modal screen.

Note: Not all syncing providers support granting access to a directory. Without this, Plain Org is unable to resolve file links.

File structure
Documents/report.org
Documents/subdir/image.png
Documents/subdir/foo.org
Documents/subdir/document.pdf
Documents/report.org
[[file:subdir/foo.org][Foo]]
[[file:subdir/image.png]]
[[file:subdir/document.pdf]]

Note: Relative link resolution requires the org file's owning directory (i.e. Documents) to be a parent of the linked file.

Unsupported
 [[file:../Desktop/foo.org][Foo]]


powered by LMNO.lol

privacy policy · terms of service