Repository navigation
VacuumStream v0.1.0
VacuumStream 0.1.0
The first public release of VacuumStream, a controller-first Twitch client for Linux x86_64.
Highlights
- Navigate with four arrow keys, Enter, and Escape, or a gamepad/Steam Input mapping.
- Guest Quick watch and exact-channel search; connect Twitch for personalized discovery.
- A public Twitch Client ID is included, with an optional Settings override.
- Official Twitch live/VOD player with separate play/pause, mute, and fullscreen controls.
- Responsive handheld-to-4K interface and secure-keyring token storage when available.
- AppImage and Flatpak packages using Electron 44.2.0; Flatpak uses Freedesktop 25.08.
- New user, contributor, and maintainer documentation, including a homepage screenshot.
Install
Download the AppImage or Flatpak attached below, plus SHA256SUMS.
The assets are attached automatically after the release build completes.
sha256sum --check --ignore-missing SHA256SUMSFor AppImage:
chmod +x VacuumStream-0.1.0-x86_64.AppImage
./VacuumStream-0.1.0-x86_64.AppImageFor Flatpak (1.16 or newer):
flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install --user ./VacuumStream-0.1.0-x86_64.flatpak
flatpak run io.github.eliottness.VacuumStreamSee the user guide
for FUSE alternatives, controller setup, and Steam Gaming Mode.
Validation and limitations
- CI passed on Node 24.20.0 and 26.8.1, including 28 tests, lint, typecheck, and packaging.
- Locally built AppImage and Flatpak passed Home, Settings, Search, and Escape navigation smoke tests.
- This is early-stage software. Physical Steam Deck/Bazzite, native GPU/audio, and fully authenticated
Twitch playback have not been comprehensively validated. Flatpak runtime smoke testing used an
isolated non-root Linux container with a virtual display. - Twitch controls ads and availability. Device sign-in authenticates discovery, not the embedded player.
- Without a secure keyring, sign-in lasts only for the current application session.
- Checksums detect corruption but are not publisher signatures. This is not a Flathub release.
- Contributor build note: electron-vite 5's declared peer range does not yet include Vite 8, although
the current pairing passes the test/build matrix without overrides.
Report reproducible problems through the issue templates.