commit 6be0603d11ba4a5075269e3511bc0feea6980574
Author: yuriy <yuriyz@disroot.org>
Date:   Mon Jun 22 19:12:11 2026 -0400

    first commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..30ac729
--- /dev/null
+++ b/README.md
@@ -0,0 +1,84 @@
+# Freedomain Mobile
+
+Android-first (for now) mobile app for the Freedomain platform. Listen to the full
+public catalog, stream or download episodes, audiobooks, playlists and chat with the Freedomain AI assistants — all from your phone.
+
+
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="assets/freedomain-mobile-image-preview-dark.png">
+  <source media="(prefers-color-scheme: light)" srcset="assets/freedomain-mobile-image-preview.png">
+  <img alt="Freedomain Mobile Preview" src="assets/freedomain-mobile-image-preview.png">
+</picture>
+
+
+## Features
+
+### Podcasts
+- **Full public catalog** — browse every Freedomain episode, newest first.
+- **Instant scrolling** — the catalog is quietly cached on your device, so
+  paging through thousands of episodes is fast and works offline once loaded.
+- **Powerful search** — search by title, description, or tags, and narrow results
+  with tag filters. Choose exactly which fields to match against.
+- **Rich episode pages** — artwork, full description, chapters, file size, and
+  links to the episode on YouTube, Rumble, Substack, X, and more.
+
+### Premium podcasts
+- Unlock premium content by entering your access URL in **Settings**.
+- Once unlocked, premium episodes appear in their own section and behave just
+  like the public catalog.
+- Premium episodes stay available offline even if your access URL later expires —
+  you only need it again to fetch new episodes.
+
+### Playback
+- **Stream or download** any episode for offline listening.
+- **Mini player** stays docked at the bottom of the app so you can keep browsing
+  while you listen.
+- **Full-screen player** with artwork, a scrubbable seek bar, chapter navigation,
+  and adjustable playback speed (0.75× to 2×).
+- **Resume where you left off** — the app remembers your position in every
+  episode, even after switching between them.
+- **Background & lock-screen playback** — keep listening with the screen off, and
+  control playback (play/pause, skip ±30s, seek) right from the lock screen and
+  notification shade, complete with artwork.
+
+### Downloads
+- Download episodes to listen without using data.
+- A dedicated **Downloads** screen lists everything saved on your device with
+  file size and download date.
+- Swipe to delete, or clear all downloads at once from Settings.
+
+### AI Chat
+- Chat directly with the Freedomain AI assistants, including:
+  - **StefBOT** — philosophy
+  - **Peaceful Parenting AI**
+  - **Real-Time Relationships AI**
+  - **Bitcoin AI**
+  - **Call-In AI**
+- Each assistant keeps its own conversation, with suggested starter questions to
+  get going.
+
+### Sharing & links
+- Tap a shared `fdrpodcasts.com` episode link and it opens straight to that
+  episode in the app.
+- Share an episode from the player — optionally including your current playback
+  position so others can pick up at the same moment.
+
+### Settings
+- Save or update your premium access URL.
+- Set a default playback speed.
+- See how much storage your downloads are using and clear them.
+
+### Look & feel
+- **Light and dark mode** — automatically follows your system theme.
+- Clean, simple navigation via the sidebar menu.
+
+## Requirements
+
+- Android 8.0 (API 26) or newer.
+
+## Premium access
+
+Public podcasts are free and require no login. Premium content requires an access
+URL, which you enter under **Settings → Premium Access URL**. The URL changes
+periodically; just update it in Settings when it does.