freedomain-mobile-public/README.md

# Freedomain Mobile

Android-first (for now) mobile app for Freedomain. Listen to the full public and premium catalog, stream or download episodes, audiobooks, and playlists, chat with
the Freedomain AI assistants, and jump straight to every Freedomain social account — all from one app.

## Download
For now you will have to side-load the app while we are beta testing it:
[Download the .APK file by clicking HERE](https://freedomain.dev/yuriy/freedomain-mobile-public/raw/branch/main/freedomain-mobile.apk)


## Screenshots
| Sidebar | Podcasts | Now Playing |
| --- | --- | --- |
| <img src="assets/screenshots/sidebar.png" width="250" /> | <img src="assets/screenshots/podcasts.png" width="250" /> | <img src="assets/screenshots/now-playing.png" width="250" /> |

| Playlists | Books | AI Chat |
| --- | --- |  --- |
| <img src="assets/screenshots/playlists.png" width="250" /> | <img src="assets/screenshots/books.png" width="250" /> | <img src="assets/screenshots/stefbots-chat.png" width="250" /> |



## 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 HTML description (selectable for copy/paste), 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.

### 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.
- Available once you've saved a premium access URL in **Settings**.

### Books
- Browse the full catalog of Stefan Molyneux's books — *The Present*, *The Future*, *Peaceful Parenting*, *Essential Philosophy*, and many more.
- Listen to built-in audiobook editions right in the app, with the same mini player, full player, downloads, and resume-position support as podcasts.
- Each book links out to its website, print/eBook/PDF editions, and translations.

### Playlists
- Browse curated episode playlists pulled live from the Freedomain catalog.
- Tap a playlist to see its episodes, then play or download them just like the main feed.

### Premium Playlists
- Premium subscribers get an extra set of curated playlists. Available once your premium access URL is added in **Settings**.
- Episodes play and download exactly like the rest of the app.

### Socials
- A dedicated **Socials** section lists every platform Freedomain is on — YouTube, X, Rumble, BitChute, Odysee, Locals, Telegram, Substack, and more,
- Tap a card to open the platform in your browser.

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