Cannot read file. Try exporting it as UTF-8 text and open it again.
Browser storage failed. Settings or cached files may not be saved.
Viewer Org
Local read-only Org viewer
Tap + to open .org file.
Files are opened locally in your browser. Nothing is uploaded.
Install on iPhone/iPad
In Safari: Share → Add to Home Screen.
If the app looks stale, use Reload app shell, then restart the PWA.
Check the current web version here or in Help.
Recent files
Viewer Org Help
What is Viewer Org?
Viewer Org is a local, read-only viewer for plain .org files. It is meant for people who keep tasks, notes, routines, projects or archives in Org-mode files and want a fast mobile/PWA view without uploading private data anywhere.
Use it as a companion to Emacs Org-mode, beorg and Plain Org: edit files in your normal editor, then open the same plain text files here for reading, agenda review, search and navigation.
What can it do?
Read large Org files: render headings, paragraphs, links, drawers, planning lines, tables, source blocks and quote blocks.
Navigate outlines: expand/collapse headings and jump from agenda/review rows back into document context.
Find information: search text, tags, TODO states and priorities; jump through matches; scope search to one subtree.
Build a daily agenda: collect SCHEDULED, DEADLINE and optional CLOSED items from selected file snapshots.
Review work: see recently closed tasks, overdue tails, waiting items, stuck projects and unscheduled actionable tasks.
Work offline: install as a PWA, reopen cached files, and keep app/cache state visible.
Stay read-only: Viewer Org does not edit or rewrite your files.
What is it not?
It is not an editor: there is no capture, edit, refiling or sync engine.
It is not a cloud service: files are not uploaded to a server.
It does not fully emulate Emacs Org-mode; complex recurrence expansion and every Org feature are intentionally out of scope for now.
Basics
Open file: use Open .org file on the opening screen, or the floating + while reading. The viewer reads the selected file locally and keeps a browser cached text copy for quick reopen.
Doc / Agenda: use the top segmented control to switch between the document reader and the local agenda. You can select multiple files; Viewer Org keeps local cached snapshots and uploads nothing.
More: use ⋯ for appearance, agenda presets, startup behavior, cache/update actions and Help.
Themes: More → Appearance → Theme: Auto, soft Light, Dark, warm Sepia, Quiet light/dark, Nord or Catppuccin Mocha. Auto follows the system; other choices override it and are saved.
Document view
Outline: headings can be expanded/collapsed. TODO, priority and tags are shown inline without editing the file.
Overview: shows heading/task/tag counts and the loaded web build when you need diagnostics.
Tags: opens a per-file tag cloud. Tapping a tag applies tag search; Clear removes it.
Context: filtered results keep parent context and heading paths so nested matches are easier to locate.
Copy heading: double-click a heading name on desktop or double-tap it on a phone to copy its plain-text name. With a keyboard, focus the heading row with Tab and press C.
Links: external links open in the browser; internal links jump inside the document; file: links open only an already opened file with its exact name, optionally at a heading or ID.
Search
Text search: type plain text. Matches are highlighted, the counter shows current/total, and ↑/↓ jumps between matches.
Subtree search: after searching, use Search here on a heading to limit results to that section. Use All document to remove the scope.
Structured search: use #work or tag:work, todo:next, priority:a.
Clear: press ×, Esc in the search field, or the tag-cloud Clear action.
Agenda
Agenda shows scheduled/deadline headings from selected local file snapshots, including repeated beorg-style tasks without a TODO keyword. Completed CLOSED tasks are optional.
Controls / Filters: open compact spoilers when you need List/Review or filters.
Workflow presets: Today, Waiting, Overdue, Review, Completed history and priority-focused Today presets.
Agenda range: choose Due, This week, This + next week, Next 7/14/30 days or All open.
Quick filters: filter by TODO state, text or #tag. Use Reset to clear agenda filters.
Always in focus: in Settings → Agenda → Always in focus, enter active TODO states separated by commas, for example READING. Matching headings stay above dated work without adding a due date, overdue status, count or badge.
Repeating tasks:🔁 before TODO means the planning date has an Org repeater such as +1d. Show or hide it in Settings → Agenda → Repeat marker.
Priority workflows: use Priority A/B/C Today presets or priority:a search when you need focused priority review.
Open task: tap a row to jump to its heading. Back returns to the previous list/search context.
Triage
Overdue: decide whether to do it, reschedule with a reason, or cancel it.
Waiting: follow up, keep waiting, or close the task.
Stuck projects: only headings explicitly marked :PROJECT: or with a progress cookie such as [/]/[0/3]. A scheduled open action today or later counts as a defined next action.
No scheduled date: schedule it, move it to backlog, or remove it. Repeated reschedules: remove the cause, not only the date.
Summary
Periods: switch between 7d, 30d and This year.
Metrics and sections: Completions, Unique tasks, Closed overdue and recently closed task history.
Files / iCloud workflow
Use Open .org file on the opening screen, or the floating + while reading, to open a user-selected .org file from Files, iCloud Drive, beorg or Plain Org exports.
Recent files reopen a browser-cached text copy for speed; use Open .org file again when the source file changed.
Safari/iOS does not give this PWA a permanent live file handle, so reopening from cache is not the same as syncing from iCloud.
Org habit graphs
Open TODO tasks with own STYLE: habit and a valid SCHEDULED repeater show a read-only graph in List, not Focus. Blue: not due; green: ready; yellow: last day; red: overdue. * means done (not necessarily green); ! marks today without a completion. Pale cells are non-overdue days without completion or future days. Day descriptions are available to screen readers.
For .+2d/4d, the last day is SCHEDULED + 2 days: Today includes the allowed interval; List, badge and Triage count overdue only afterwards. The raw schedule stays labelled; a separate DEADLINE is unchanged. Supports d/w/m/y (months and years are fixed day durations), not hourly minimum repeats. Invalid input keeps the ordinary row with an explanation. History uses terminal-state logs and default closing notes, not CLOSED/LAST_REPEAT or literal examples. The Emacs 9.7.11 default window has 28 colored days and one final blank. No editing, future occurrence expansion or sync; reopen changed files.
beorg / Plain Org habits
SCHEDULED, DEADLINE and optional CLOSED planning lines are the agenda source of truth.
Scheduled headings without TODO are included for beorg-style daily habits and routines.
Repeater cookies such as +1d are preserved in the source line; recurrence expansion is not implemented.
The viewer does not write proprietary metadata back to your plain .org files.
Report diagnostics
Diagnostics are off by default. Use Settings → Support → Diagnostics → On first, then Export diagnostics to create a JSON report with version, browser, settings summary, counts and a human-readable startup performance summary. It does not include Org file content or file names.
Privacy
All files stay in your browser. The web viewer never uploads your .org files to any server. There is no analytics or telemetry by default.
Multi-file agenda remains local-only: only user-selected files, browser cached snapshots, visible source labels, stale cached-source warnings, and clear cached data controls. Reopen files to refresh changed iCloud/Files exports.
Keyboard shortcuts
/ — open and focus document search (same as the Search button)
? or H — open this Help (same as More → Help)
Esc — in search: clear query, then close search; otherwise close the top Help, More, source-list, or document-tools layer
Enter / Space — open focused agenda/review row
C — copy the focused document heading name (not inside links or input fields)
Tab / Shift+Tab — move keyboard focus through controls and rows
Cache / Updates
App shell cache stores the viewer itself. Cached org file is the last file copy saved in this browser for quick reopen. If UI updates look inconsistent, verify the version below, reload app shell, then clear site data if needed.
Installed PWA
Installed mode: Browser tab. Add to Home Screen for a standalone app-like view; app icon badge remains optional and falls back gracefully when unsupported.
Что такое Viewer Org?
Viewer Org — локальный read-only просмотрщик обычных .org файлов. Он нужен, если задачи, заметки, привычки, проекты или архивы живут в Org-mode, а на телефоне хочется быстро читать, искать и смотреть agenda без загрузки приватных данных на сервер.
Это companion к Emacs Org-mode, beorg и Plain Org: редактируй файлы в привычном редакторе, а здесь открывай те же plain text файлы для чтения, agenda review, поиска и навигации.
Что он умеет?
Читать большие Org-файлы: заголовки, абзацы, ссылки, drawers, planning lines, таблицы, source и quote blocks.
Навигировать outline: сворачивать/разворачивать headings и прыгать из agenda/review обратно в контекст документа.
Искать: текст, теги, TODO-состояния и приоритеты; переходить по совпадениям; ограничивать поиск одним subtree.
Строить agenda: собирать SCHEDULED, DEADLINE и optional CLOSED из выбранных локальных snapshots.
Делать review: recently closed, overdue tails, waiting items, stuck projects и unscheduled actionable tasks.
Работать offline: PWA, cached files, понятное состояние app/cache.
Оставаться read-only: Viewer не редактирует и не переписывает файлы.
Чем он не является?
Это не редактор: нет capture, edit, refile или sync engine.
Это не облачный сервис: файлы не загружаются на сервер.
Это не полная эмуляция Emacs Org-mode; сложная recurrence expansion и все возможности Org пока вне scope.
Основы
Открыть файл: нажми Открыть .org файл на стартовом экране или floating + при чтении. Viewer локально читает файл и сохраняет browser cached text copy для быстрого reopen.
Док / Дела: верхний segmented control переключает document reader и локальную agenda. Можно выбрать несколько файлов; Viewer Org хранит локальные cached snapshots и ничего не загружает на сервер.
Темы: Меню → Внешний вид → Тема: Авто, мягкая Светлая, Тёмная, тёплая Сепия, Nord или Catppuccin Mocha. Авто следует системе; остальные темы не зависят от неё и сохраняются.
Документ
Outline: headings сворачиваются/разворачиваются. TODO, priority и tags показываются inline без изменения файла.
Обзор: показывает counts headings/tasks/tags и web build для диагностики.
Теги: открывает tag cloud текущего файла. Tap по тегу включает tag search; Сбросить убирает его.
Контекст: filtered results сохраняют parent context и heading paths для вложенных совпадений.
Копировать имя: сделай double-click по имени heading на desktop или double-tap на телефоне, чтобы скопировать plain-text имя. С клавиатуры: перейди к строке заголовка клавишей Tab и нажми C.
Ссылки: external открываются в браузере; internal прыгают внутри документа; file: открывает только уже открытый файл с точным именем, при необходимости — heading или ID.
Поиск
Text search: введи текст. Matches подсвечиваются, счётчик показывает current/total, ↑/↓ переходят между совпадениями.
Subtree search: после поиска нажми Искать здесь на heading, чтобы ограничить результаты этим разделом. Весь документ сбрасывает область.
Structured search:#work или tag:work, todo:next, priority:a.
Сброс: нажми ×, Esc в поле поиска или Clear рядом с tag cloud.
Дела
Agenda показывает scheduled/deadline headings из выбранных локальных snapshots, включая beorg-style повторяющиеся задачи без TODO keyword. Завершённые CLOSED задачи опциональны.
Управление / Фильтры: компактные spoilers для List/Review и filters.
Workflow presets: Today, Waiting, Overdue, Review, Completed history и priority-focused Today presets.
Диапазон дел: Срок, Эта неделя, Эта + следующая, 7/14/30 дней или Все открытые.
Quick filters: TODO state, text или #tag. Reset очищает agenda filters.
Всегда в фокусе: в Настройки → Дела → Всегда в фокусе впиши активные TODO-состояния через запятую, например READING. Совпавшие headings останутся над датированными делами без даты, просрочки, счётчика или badge.
Повторяющиеся задачи:🔁 перед TODO означает, что у даты есть Org-repeater, например +1d. Метка включается и скрывается в Settings → Дела → Метка повтора.
Priority workflows: используй пресеты Priority A/B/C Today или поиск priority:a для фокусного обзора приоритетов.
Открыть задачу: tap по строке прыгает к heading; Назад возвращает предыдущий список/search context.
Итоги
Периоды: 7 дней, 30 дней и этот год.
Метрики и секции: недавние завершения, закрыто с просрочкой, просрочено, старые хвосты, ожидание, застрявшие проекты и без даты.
Files / iCloud workflow
Нажми Открыть .org файл на стартовом экране или floating + при чтении, чтобы открыть выбранный пользователем .org файл из Files, iCloud Drive, beorg или Plain Org export.
Recent files открывают browser-cached text copy для скорости; если source file изменился, снова используй Открыть .org файл.
Safari/iOS не даёт PWA постоянный live file handle, поэтому cached reopen — это не sync из iCloud.
Графики Org-привычек
Открытая TODO-задача с собственным STYLE: habit и корректным повтором SCHEDULED получает график только в Списке, не в Фокусе. Синий: рано; зелёный: можно выполнить; жёлтый: последний день; красный: просрочено. * — выполнено (не обязательно зелёный); ! — сегодня без выполнения. Бледные ячейки — непросроченные дни без выполнения либо будущие дни. Скринридер получает описание каждого дня.
Для .+2d/4d крайний день — SCHEDULED + 2 дня: весь допустимый интервал относится к Сегодня, просрочка в Списке, badge и Разборе начинается позже. Исходная дата подписана честно; отдельный DEADLINE не меняется. Поддержаны d/w/m/y (месяцы и годы — фиксированное число дней), но не часовой минимум. Ошибочный формат оставляет обычную строку с пояснением. История — журнальные переходы в конечные состояния и стандартные closing notes, не CLOSED/LAST_REPEAT и не примеры кода. Окно Emacs 9.7.11: 28 цветных дней и последняя пустая ячейка. Без редактирования, генерации повторов и синхронизации; изменённый файл нужно переоткрыть.
beorg / Plain Org привычки
SCHEDULED, DEADLINE и optional CLOSED — источник agenda.
Scheduled headings без TODO включаются для beorg-style daily habits/routines.
Repeater cookies вроде +1d сохраняются в source line; recurrence expansion не реализован.
Viewer не пишет proprietary metadata обратно в plain .org.
Report diagnostics
Диагностика выключена по умолчанию. Сначала включи Settings → Support → Диагностика → Вкл, потом нажми Экспорт диагностики, чтобы создать JSON report с version, browser, settings summary, counts и понятной сводкой скорости запуска. В нём нет Org file content и file names.
Приватность
Все файлы остаются в браузере. Web viewer не загружает .org файлы на сервер. Analytics/telemetry по умолчанию нет.
Multi-file agenda остаётся local-only: только выбранные пользователем файлы, browser cached snapshots, видимые source labels, stale cached-source warnings и clear cached data controls. Чтобы обновить изменённые iCloud/Files exports, переоткрой файлы.
Горячие клавиши
/ — открыть и поставить фокус в поиск по документу (как кнопка Search)
? или H — открыть эту справку (как Ещё → Help)
Esc — в поиске: очистить запрос, затем закрыть поиск; иначе закрыть верхний слой Help, Ещё, списка файлов или инструментов документа
Enter / Space — открыть focused agenda/review row
C — копировать имя заголовка документа в фокусе (не внутри ссылок и полей ввода)
Tab / Shift+Tab — перемещать keyboard focus
Cache / Updates
App shell cache хранит сам viewer. Cached org file — последняя копия файла в браузере для quick reopen. Если UI выглядит старым, проверь версию ниже, обнови app shell, затем при необходимости очисти site data.
Installed PWA
Режим запуска: Browser tab. Добавь на Home Screen для standalone app-like режима; app icon badge optional и gracefully falls back, если не поддержан.
Version
Version:
Technical build:
Update status
App shell cache: —
App shell status: —
Service worker: Unknown
Last Reload app shell: Never
Startup performance
Startup health: —
Startup mode: —
Timing: —
Cache: —
Hint: —
For fast startup, open the last cached file automatically.