OpenStream is a modern, open-source, cross-platform desktop application that brings RSS feeds, YouTube channels, and podcasts together in one unified interface. Built with Rust, Tauri, and React, it offers secure local storage, customizable feeds, podcast playback, audio conversion, and a privacy-first experience.
  • Rust 50.9%
  • TypeScript 40%
  • JavaScript 4.5%
  • CSS 4.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
federico bc9b37aaa1
Some checks failed
CI / check (linux-x64) (push) Has been cancelled
CI / check (macos-arm64) (push) Has been cancelled
CI / check (windows-x64) (push) Has been cancelled
CI / licenze e advisory (push) Has been cancelled
chore: .gitignore senza voci dei file di lavoro locali
2026-11-14 22:50:08 +01:00
.forgejo docs: README e guida utente in inglese e italiano, architettura, supporto e modelli (M12a) 2026-11-13 20:22:21 +01:00
.vscode chore: bootstrap OpenStream (M0) 2026-11-11 16:08:11 +01:00
design chore: bootstrap OpenStream (M0) 2026-11-11 16:08:11 +01:00
docs chore: note di lavoro e file degli strumenti locali fuori dal repository 2026-11-14 22:39:55 +01:00
e2e feat: server locale per la riproduzione su Linux (ADR 0012) 2026-11-13 18:05:24 +01:00
fixtures feat: pacchetti, firma e aggiornamenti firmati (M11) 2026-11-13 00:59:51 +01:00
scripts feat: autore e sito in Informazioni e nei metadati del pacchetto 2026-11-13 12:24:28 +01:00
src chore: versione 0.1.2 e checklist di release (M12b) 2026-11-13 21:23:08 +01:00
src-tauri chore: versione 0.1.2 e checklist di release (M12b) 2026-11-13 21:23:08 +01:00
.gitignore chore: .gitignore senza voci dei file di lavoro locali 2026-11-14 22:50:08 +01:00
.prettierignore chore: note di lavoro e file degli strumenti locali fuori dal repository 2026-11-14 22:39:55 +01:00
.prettierrc.json chore: bootstrap OpenStream (M0) 2026-11-11 16:08:11 +01:00
CHANGELOG.md docs: data di pubblicazione della 0.1.2 nel CHANGELOG (M12b) 2026-11-14 20:31:15 +01:00
CONTRIBUTING.md chore: versione 0.1.2 e checklist di release (M12b) 2026-11-13 21:23:08 +01:00
DESIGN.md docs: confermati nome guida e nomi dei colori del design system 2026-11-11 17:50:54 +01:00
eslint.config.js feat: design system e shell desktop (M1) 2026-11-11 17:28:38 +01:00
index.html chore: bootstrap OpenStream (M0) 2026-11-11 16:08:11 +01:00
LICENSE chore: bootstrap OpenStream (M0) 2026-11-11 16:08:11 +01:00
OPENSTREAM_TECHNICAL_BLUEPRINT.md chore: note di lavoro e file degli strumenti locali fuori dal repository 2026-11-14 22:39:55 +01:00
package.json chore: versione 0.1.2 e checklist di release (M12b) 2026-11-13 21:23:08 +01:00
pnpm-lock.yaml feat: E2E, accessibilità, benchmark ed error boundary (M10b) 2026-11-12 22:14:22 +01:00
README.it.md feat: pulsante «Aggiungi un feed» nella vista Feed RSS 2026-11-13 21:18:55 +01:00
README.md feat: pulsante «Aggiungi un feed» nella vista Feed RSS 2026-11-13 21:18:55 +01:00
rust-toolchain.toml chore: bootstrap OpenStream (M0) 2026-11-11 16:08:11 +01:00
SECURITY.md docs: README e guida utente in inglese e italiano, architettura, supporto e modelli (M12a) 2026-11-13 20:22:21 +01:00
SUPPORT.md docs: README e guida utente in inglese e italiano, architettura, supporto e modelli (M12a) 2026-11-13 20:22:21 +01:00
THIRD_PARTY_LICENSES.txt feat: server locale per la riproduzione su Linux (ADR 0012) 2026-11-13 18:05:24 +01:00
THIRD_PARTY_NOTICES.md feat: pacchetti, firma e aggiornamenti firmati (M11) 2026-11-13 00:59:51 +01:00
tsconfig.json chore: bootstrap OpenStream (M0) 2026-11-11 16:08:11 +01:00
tsconfig.node.json chore: bootstrap OpenStream (M0) 2026-11-11 16:08:11 +01:00
vite.config.ts feat: design system e shell desktop (M1) 2026-11-11 17:28:38 +01:00

OpenStream

A local-first desktop reader for RSS feeds, YouTube channels and podcasts, with an encrypted library.

Italiano · User guide · Download · Security · License: MIT

OpenStream with a podcast episode open and the player at the bottom, dark violet theme

OpenStream keeps your feeds, the YouTube channels you follow and your podcasts in one library on your computer. There's no account and no server: everything you read and listen to stays in a database encrypted with a passphrase only you know.

Status: beta (0.1.x). macOS (Apple Silicon) and Linux x86_64. Windows isn't supported yet.

What it does

  • RSS, Atom and JSON Feed. Updates on its own at the interval you choose. Articles are shown formatted but never as remote web pages. Unread, starred and read-later lists, folders, tags, full-text search, OPML import and export.
  • YouTube channels, without a Google account. Follow a channel through its public feed: new videos appear in your library and open in your browser. OpenStream never downloads videos and doesn't touch your YouTube account.
  • Podcasts. A player that stays put while you browse, with a queue, speed control and resume from where you left off. Download episodes for offline listening, with a space limit you set.
  • Local audio conversion. Convert downloaded episodes or your own audio files to MP3, AAC/M4A, Opus, Vorbis, FLAC or WAV, using the FFmpeg installed on your computer.
  • Encrypted from the first launch. The library is a SQLCipher database. Optional unlock with the system keychain, automatic lock after inactivity, encrypted backups you can restore on another computer.
  • Signed updates. Updates are checked only when you ask, or after unlocking if you turn that on, and installed only if their signature is valid.
  • Italian and English, three themes, full keyboard use.
All content, with the listening queue open Downloads and conversion

Settings: themes, language, security

Screenshots of OpenStream 0.1.x with the Italian interface (English is available in Settings). The images in design/ are early design concepts, not the product.

Download and install

Get the latest version from the releases page. Check the files against SHA256SUMS before installing (see SECURITY.md).

System File Notes
macOS 12.3+ on Apple Silicon OpenStream_<version>_aarch64.dmg Signed and notarized: drag it to Applications.
Debian, Ubuntu, Linux Mint OpenStream_<version>_amd64.deb sudo apt install ./OpenStream_<version>_amd64.deb, then run openstream. Pulls in the GStreamer plugins needed for audio.
Fedora and other RPM distributions OpenStream-<version>-1.x86_64.rpm Built but not yet tested on an RPM distribution.
Any x86_64 Linux OpenStream_<version>_amd64.AppImage chmod +x and run. Includes GStreamer. Needs libfuse2 (libfuse2t64 on Ubuntu 24.04). The only Linux package that updates itself.

Your data lives in the system's app data folder and isn't removed when you uninstall:

  • macOS: ~/Library/Application Support/dev.federicorinaldi.openstream/
  • Linux: ~/.local/share/dev.federicorinaldi.openstream/

Quick start

  1. Create your vault. On first launch choose a passphrase of at least 12 characters. It can't be recovered: if you lose it and haven't turned on keychain unlock, your data is gone.
  2. Add sources from Library: Add source (RSS, Atom or JSON Feed address), Follow a YouTube channel (the channel ID, it starts with UC), Add a podcast (the podcast's RSS feed address) or Import OPML if you're coming from another reader. The RSS feeds, YouTube and Podcasts views have their own add button too.
  3. Read and listen. J/K move through the list, M marks read, S stars, Space plays or pauses. Mod+K opens the command palette (Mod is ⌘ on macOS, Ctrl on Linux). All shortcuts: docs/shortcuts.md.
  4. Make a backup. Settings → Backup and restore.

The user guide covers each feature in detail.

Privacy

  • No telemetry, no analytics, no account. The only server run by the project is the release server, contacted only when you check for updates.
  • Network traffic only for what you ask for. The app contacts the feeds and podcasts you add, the YouTube feeds of the channels you follow and, when you check, the update server. All requests go through the app's backend, which blocks addresses on your local network unless you allow them (Settings → Home network).
  • Remote images are always blocked, so senders can't tell when you read. Links open in your browser after showing you the address.
  • Podcast audio is streamed through the app: the podcast server sees your IP address, with no cookies.
  • The diagnostics file (Settings → About) contains versions, counts and error codes: no titles, addresses, paths or passphrases. It's saved where you choose and never sent anywhere.

What encryption covers, and what it doesn't

  • Encrypted: the library database (sources, articles, read status, tags, settings, playback positions) and backups.
  • Not encrypted: downloaded episodes and converted files. They're normal files in the download folder, and the app says so where you choose it.
  • Keychain unlock is convenient on a personal computer, but anyone who can sign in to your user account can then open the library.
  • OpenStream can't protect you from malware already running on your computer. Deleted files on an SSD may still be physically recoverable.

Media and YouTube

  • OpenStream downloads only the audio and video files that a podcast feed publishes for listening. It doesn't get around DRM or paywalls.
  • YouTube: OpenStream reads each channel's public feed and opens videos on youtube.com in your browser. It never downloads or plays YouTube videos in the app, and it isn't affiliated with YouTube or Google. Using YouTube is subject to YouTube's terms.
  • Conversion is meant for files you have the right to use. OpenStream doesn't include FFmpeg: it uses the one you install, after you approve it. GPL builds of FFmpeg are fine for use on your own computer; OpenStream doesn't redistribute them.

Known limitations

  • No Windows version yet.
  • Remote images can't be loaded, not even on request (planned).
  • YouTube @handle addresses aren't accepted: you need the channel ID. The user guide shows how to find it.
  • Linux playback goes through a small local server on 127.0.0.1 (WebKitGTK can't play audio from the app's internal protocol), and streaming starts a little slower than on macOS. See ADR 0012.
  • Which formats play depends on the system's decoders: MP3 has been tested on macOS and Linux; AAC/M4A and other formats depend on the system (on Linux, on the GStreamer plugins installed; the AppImage includes them). An episode that won't play can still be downloaded and opened in another app.
  • JSON Feed attachments and non-UTF-8 feeds get no episode details (duration, numbering).
  • After restoring a backup on another computer, downloads listed as completed point to files that aren't there: they stream normally, and you can delete them from Downloads.
  • FFmpeg runs without a sandbox. It decodes the files you choose with your user's permissions; OpenStream restricts formats and decoders. See docs/security-audit-m10.md (F-06).
  • No sync between computers. Use a backup to move your library.

Building from source

You'll need rustup (the pinned Rust toolchain installs itself), Node.js 22 or later (developed with 26) pnpm 12.18.0 (npm install -g pnpm@12.18.0) and, for pnpm check, cargo-deny (cargo install cargo-deny --locked). On Linux, also the system packages listed in CONTRIBUTING.md.

git clone https://code.federicorinaldi.dev/federico/openstream.git
cd openstream
pnpm install --frozen-lockfile
pnpm tauri dev      # development window, with generated demo data
pnpm check          # everything the CI would run: types, lint, tests, licenses, Rust
pnpm tauri build --config '{"bundle":{"createUpdaterArtifacts":false}}'   # unsigned installable package

No secrets or cloud services are needed. Developer documentation (in Italian): CONTRIBUTING.md, docs/architecture.md, decision records, release process.

License

OpenStream's code is released under the MIT license. The app includes third-party components under their own licenses (MIT, Apache-2.0, BSD, MPL-2.0, ISC, Unicode and others): see THIRD_PARTY_NOTICES.md, the full texts in THIRD_PARTY_LICENSES.txt (also in Settings → About), and the software bill of materials in docs/sbom/.

Support and questions: SUPPORT.md. Security issues: SECURITY.md, privately.