duckeye

Help

How to open things in duckeye, and what each control does.

Contents: Share to duckeye · Type an address · Open a file · Sites that refuse · The toolbar · duckeye, Source, Text · Doc, Data, Viz · Find and Query · Extract and Read · Privacy

Share a link or text to duckeye

  1. In your browser or another app, tap Share.
  2. Pick duckeye.

If the shared text holds a web address, duckeye opens that page. Browsers often send the page title before the address, and that is fine. Text with no address opens as plain text.

You can also share a file to duckeye from an app that shares files, such as a mail or chat app.

To open a web address you see in any app, select it and pick duckeye from the menu. An address that reaches duckeye this way, or from a duckeye link, opens over https:// only, and never a device on your own network.

Type an address

  1. Tap ☰, or tap the title at the top.
  2. Type the address in the field at the top of the drawer.
  3. Press Enter.

You can leave out https://. An address cannot hold spaces.

The same field takes a DuckDB table expression. Type a query that starts with SELECT, WITH or FROM, or a call such as range(10). Text that you share from another app never runs as SQL.

Open a file

There are two ways:

duckeye finds the format from the file's type, then from its name. If a file opens in the wrong format, tap ☰ and change Parsed as in About.

duckeye reads HTML, Markdown, text, CSV, TSV, JSON, JSON Lines, Parquet, Excel (XLSX), DOCX, ODT, EPUB, RTF, Jupyter notebooks, LaTeX, reStructuredText, Org, MediaWiki and Textile. It opens DuckDB and SQLite files read-only, and shows source code as numbered lines. It does not read YAML files. PDF support is coming soon.

The Files app offers duckeye only for the file types that duckeye registers. If duckeye is not in the list, use the folder button in ☰. It accepts any file.

Sites that refuse duckeye

Some sites refuse apps, or need you to sign in. When a site answers with status 401, 403, 429 or 503, duckeye offers the browser view. Sign in or pass the check there, and duckeye reads the page when it loads.

The toolbar

☰ The drawer
The address field, then Back, Save, Reload, Open file and Close (closes the page). Below them: About (with Parsed as), the page's Contents, and for a table its Columns. Tap a column's bar to filter by it.
⧉ Copy
Copies what is shown, in the format that is shown.
Share
Shares the page as Markdown, for example to Claude, ChatGPT or a notes app.
⋯ More
Open with, Open in browser, Copy address, Full screen, Print, Ask an AI (a prompt about the open table, for any AI; duckeye sends nothing), Style, Theme, Help, Licences and Clear browsing data (the cookies and site storage of the browser view and Source).
⌕ Find
Opens the Find and Query bar. See below.

Android's Back button goes back to the last page.

The duck button: duckeye, Source and Text

Tap 🦆 to pick how to show the page:

duckeye
The page goes through Mode, Variant and Format (below). This is the normal state.
Source
The page as a browser shows it, live. It has its own bar: Back, Reload, Extract and Read.
Text
The source text of the page or file. Tap ✎ to edit it. Undo and Redo are beside it.

Doc, Data and Viz

In the duckeye state, three menus on the second row choose the view: Mode, Variant and Format.

ModeVariantFormat
Doc: the documentReader (no header, menus, side rails or footer), Full, Outline (each section folds under its heading)View, HTML, Text, MD, Pandoc (pandoc's JSON, which pandoc on a desktop turns into DOCX, ODT or LaTeX)
Data: a tableTable, Columns (one row for each column), Cards (one card for each record), Summary (a profile of each column)View, CSV, JSON, YAML (as many rows as the Rows setting allows: 100 to 100,000, or no limit)
Viz: a chart of the tableAuto, Bar, Line, Scatter, HistogramView, SVG, Vega-Lite

A data file shows its rows in Data. A document shows its blocks in Data: one row for each heading, paragraph, list or table.

In a Table, tap a column's header to filter on it, show only it, hide it, or sort by it.

In Viz, column 1 is x and column 2 is y. A third text column splits the chart into series. Auto picks the chart from the column types.

Find and Query

Tap ⌕. The bar has two tabs.

Find

Aa Text
Plain text. Lower case ignores case. A capital letter makes the search exact.
.* Regular expression
The same case rule applies.
#id CSS selector
For example h2, table or a[href*=pdf]. Tap 💡 to get suggestions of the page's tags, classes and ids as you type.

In code, type a colon and a line number, such as :120, to go to that line.

Enter or ↓ goes to the next match. ↑ goes to the one before. ⤢ makes the field larger.

Query

Type an SQL query over the page's table. Start from SELECT * FROM doc or SELECT * FROM data. Both names point to the same table.

The view then shows the result. A chip under the toolbar shows that a query is in force. Tap the chip to clear it.

Extract and Read (Source)

In the Source state, the page runs as in a browser. Its bar has two extra buttons:

Extract ▾
Tables (pick one, and it opens in Data), Links (text, address and title), Images (alt text, address and size), Structured data (schema.org items such as recipes, products and events) or Page info (title, description, share card and canonical link).
Read
Reads the page as it is now into duckeye. Use it after you sign in or open more of the page.

Privacy

duckeye has no account, no ads, no analytics and no server. Files you open or share are read on your phone and are not uploaded.

Read the privacy policy.

Contact

Found a bug, or want a feature? Use the feedback page: on GitHub, or with a form that needs no account.

Questions or problems: duckeye@koowee.org (send mail).