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
- In your browser or another app, tap Share.
- 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
- Tap ☰, or tap the title at the top.
- Type the address in the field at the top of the drawer.
- 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:
- In duckeye, tap ☰, then the folder button. Pick the file.
- In the Files app, open the file and pick duckeye from the list of apps.
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.
| Mode | Variant | Format |
|---|---|---|
| Doc: the document | Reader (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 table | Table, 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 table | Auto, Bar, Line, Scatter, Histogram | View, 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,tableora[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.
- SQL ▴ builds the query for you: Columns, Where, Group and Order.
- Tools ▾ holds Clear (empty the box; the query in force stays), Format (lay it out, one clause on each line) and Reset (back to
SELECT * FROM dataand the whole table). - Run ▶ or Enter runs it. Shift+Enter starts a new line. Only Run runs: closing the bar, or Back, keeps your draft.
- The </> button opens the query editor, with the same tools. Its Close, or Back, keeps your draft too.
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.
- A web page comes from its own site, as in a browser. An address that another app hands to duckeye opens over
https://only, and never a device on your own network. - duckeye keeps your recent pages, your settings and a cache on your phone. ⋯ › Clear browsing data removes the cookies and site storage of the browser view and Source. Android's Clear storage for duckeye removes everything.
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).