Docs · Deep Links — preserved from Tokyo Night portal

Deep links

Two shapes, same resolver. No information lost — the full portal from index.html:324-515 (Tokyo Night, liquid-glass) now lives here, one page per job instead of one overloaded scroll.

How It Works

Two simple link formats, automatic verse resolution.

Web-Friendly Links

Standard HTTPS URLs that work in browsers and auto-open Metanoia with App Link verification.

https://metanoia.bytecats.codes/bible/John/3/16

Direct App Links

Use the metanoia:// scheme for immediate deep links without verification.

metanoia://bible/John/3/16

Smart Resolution

Full names, abbreviations (jn, 1sam), and automatic chapter/verse validation — land on src/main.zig:load_chapter_into_study with ORDER BY (version != ?) fallback.

https://metanoia.bytecats.codes/bible/jn/3/16

Integration Guide

Kotlin / Android

val intent = Intent(Intent.ACTION_VIEW, Uri.parse("https://metanoia.bytecats.codes/bible/John/3/16"))
startActivity(intent)

Web / HTML

<a href="https://metanoia.bytecats.codes/bible/Romans/8/28">Read Romans 8:28</a>

JavaScript / Web

window.open('https://metanoia.bytecats.codes/bible/Genesis/1/1', '_self');

Link Examples

✅ Tested & Working — verified with latest Metanoia app.

Link	Opens	Type
metanoia://bible/John/3/16	John 3:16	Custom
https://metanoia.bytecats.codes/bible/Genesis/1	Genesis 1 (chapter)	HTTPS
https://metanoia.bytecats.codes/bible/1Samuel/17/45	1 Samuel 17:45	HTTPS
metanoia://bible/SongofSolomon/2/1	Song of Solomon 2:1	Custom
https://metanoia.bytecats.codes/bible/jn/3/16	John 3:16 (abbrev)	HTTPS
https://metanoia.bytecats.codes/bible/Romans/8/28	Romans 8:28	HTTPS

Testing Links

⚠️ ADB Testing

adb shell am start -W -a android.intent.action.VIEW \
  -d "metanoia://bible/John/3/16" com.bytecats.metanoia

Live Testing

Test John 3:16 Test Genesis 1 Test Romans 8:28

FAQ

What if Metanoia isn't installed?

HTTPS link opens in browser; user can install from there.

Does this work on iOS?

Android-only today; iOS Universal Links planned, metanoia:// works where allowed.

Can I link to specific translations?

Not yet — opens user's preference. Translation-keyed links planned (see docs/DEEP_LINKING_GUIDE.md:294).

What about deuterocanonical books?

66-book baseline today; use full names (Tobit, etc.) for others until abbreviations land. Full 82-book picker is in Canon.

Verified via .well-known/assetlinks.jsonTokyo Night → Astryx: liquid-glass preservedCorpus principles →

Back: TTS + Whisper

Back to home