- Rust 50.9%
- TypeScript 40%
- JavaScript 4.5%
- CSS 4.5%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .forgejo | ||
| .vscode | ||
| design | ||
| docs | ||
| e2e | ||
| fixtures | ||
| scripts | ||
| src | ||
| src-tauri | ||
| .gitignore | ||
| .prettierignore | ||
| .prettierrc.json | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| DESIGN.md | ||
| eslint.config.js | ||
| index.html | ||
| LICENSE | ||
| OPENSTREAM_TECHNICAL_BLUEPRINT.md | ||
| package.json | ||
| pnpm-lock.yaml | ||
| README.it.md | ||
| README.md | ||
| rust-toolchain.toml | ||
| SECURITY.md | ||
| SUPPORT.md | ||
| THIRD_PARTY_LICENSES.txt | ||
| THIRD_PARTY_NOTICES.md | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
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 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.
![]() |
![]() |
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
- 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.
- 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. - Read and listen.
J/Kmove through the list,Mmarks read,Sstars,Spaceplays or pauses.Mod+Kopens the command palette (Modis ⌘ on macOS, Ctrl on Linux). All shortcuts: docs/shortcuts.md. - 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
@handleaddresses 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.



