Skip to content

amake/orgro

Repository files navigation

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

Orgro

An Org Mode app for iOS and Android

demo.mp4

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 are focused on very different things like to-dos or task management; Orgro is instead first and foremost a viewer, letting you see and search the contents of your org files. (Recently it also gained editing capabilities. I hope to enhance these in the future.)

I also wanted to try writing a parser with PetitParser; the result powers this application and is available as a separate library, org_parser.

Features

  • Syntax highlighting for most Org Mode syntax structures
  • Expand and collapse sections, blocks, and drawers
  • Reflow text for easy viewing on narrow screens
  • Pretty table rendering
  • Functional external links and section links (works well with Org-roam)
  • Visibility cycling
  • Search
  • Narrowing
  • Sparse Tree-style filtering
  • "Reader mode" where extraneous markup is hidden
  • Inline and block LaTeX rendering
  • Jump to/from footnotes
  • Display Org Cite citations
  • Decrypt/encrypt Org Crypt sections (currently symmetric keys only)
  • Editing capability (details)
  • Honor document-local #+STARTUP: and #+TODO: directives

See the manual for details.

Limitations

Many Org Mode syntax structures are highlighted but not meaningfully interpreted.

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 sponsoring the author ❤️