amake/orgro

Download on the App Store Get it on Google Play Get it on F-Droid

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, org_parser. Further, the display engine is also available as a separate package for any Flutter app that wants to display Org markup: org_flutter.

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:

1. Install Flutter
2. Clone this repo
3. 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 ❤️