freedomain-mobile-public/README.md

# 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.



## Screenshots

| Sidebar | Podcasts | Playlists | Books | AI Chat |
| --- | --- | --- | --- | --- |
| <img src="assets/screenshots/sidebar.png" alt="Freedomain Sidebar" width="200" /> | <img src="assets/screenshots/podcasts.png" alt="Freedomain Podcasts Screen" width="200" /> | <img src="assets/screenshots/playlists.png" alt="Playlists" width="200" /> | <img src="assets/screenshots/books.png" alt="Books Screen" width="200" /> | <img src="assets/screenshots/stefbots-chat.png" alt="Stefbots Screen" width="200" /> |

## Download
[Download the .apk file by clicking HERE](https://freedomain.dev/yuriy/freedomain-mobile-public/raw/branch/main/freedomain-mobile.apk)

## 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.