📄 README.md

Orgro

An Org Mode app for iOS and Android

https://github.com/amake/orgro/assets/2172537/a3d841a3-84f3-4c34-9381-c73ab4dc9249

What is Org Mode?

Imagine a plain-text markup language like Markdown, but married to an application that is a literate programming environment and life organizer. In Emacs.

Why?

I started taking notes in Org Mode at work, then found myself wanting to view them on my tablet in meetings. By default on iOS you can't open an .org file at all, as the OS doesn't even know that it's plain text.

Other mobile Org Mode apps seem focused on specific use cases like to-dos or task management; Orgro is instead meant to be a well-rounded and high-fidelity experience for viewing, navigating, and editing Org documents. (In the 5+ years since I started Orgro, I've added additional functionality only when it fits well into the core without compromises.)

I also wanted to try writing a parser with PetitParser; the result powers this application and is available as a separate library, orgparser. Further, the display engine is also available as a separate package for any Flutter app that wants to display Org markup: orgflutter.

Features

Display

Syntax highlighting for all Org Mode syntax structures

Expand and collapse sections, blocks, and drawers

Reflow text for easy viewing on narrow screens

“Reader mode” where extraneous markup is hidden

Pretty table rendering

Inline and block LaTeX rendering

Navigation

Visibility cycling

Narrowing

Functional external links, section links, and relative links to other Org

files (works well with Org-roam)
Search: both plain text and regexp

Sparse Tree-style filtering

Jump to/from footnotes

Jump to <<link targets>>, <<<radio targets>>>, and src block code

references like (foo)

Editing

Edit entire files or narrowed sections as plain text, with various insertion

helpers
Some “structured” editing available

Tap to toggle checkboxes

Slide sections to cycle TODO states

Tap to edit timestamps via date/time picker

Task management

Functional checkboxes, with statistics

cookies
Easy cycling of TODO states

Notifications for Org Agenda items, including recurring items

External media

Display linked images

Attachment support

Display Org Cite citations

More

Capture text and links from other apps via the standard OS share UI, and also

org-protocol:// links
Decrypt/encrypt Org Crypt

sections (currently symmetric keys only)
Honor document-local #+STARTUP:, #+TODO:, #+LANGUAGE: directives, and

some local variables

See the manual for details.

FAQ

See here

Get it

Orgro is available on the App Store, Google Play, and F-Droid, or you can build and install from source:

Install Flutter

Clone this repo

Attach your device and do flutter run from the repo root

Support Orgro

If you like this app, please show your support by buying a copy, or sponsoring the author ❤️