serrebi/BlindRSS
1
15
Fork 0
mirror of https://github.com/serrebi/BlindRSS.git synced 2026-03-18 00:16:49 -07:00
Code Issues Projects Packages Wiki Activity
A vibed accessible, modern RSS client for the blind
497 commits 2 branches 189 tags 1.8 MiB
  • Python 98.4%
  • Batchfile 1.6%
Find a file
Exact
admin 9b88976abc Release v1.63.26
2026-03-15 18:37:25 -07:00
core Release v1.63.26 2026-03-15 18:37:25 -07:00
gui Add subcategory support with nested treeview hierarchy 2026-03-15 18:33:07 -07:00
hooks refactor(playback_state): centralize lock-skipping writes 2026-01-04 19:34:23 +01:00
providers Add subcategory support with nested treeview hierarchy 2026-03-15 18:33:07 -07:00
sounds fix: NPR feed, add sounds, cleanup boilerplate, fix accessibility 2026-01-06 11:43:32 -08:00
tests Add subcategory support with nested treeview hierarchy 2026-03-15 18:33:07 -07:00
tools Update feed refreshing and Inoreader support 2026-02-14 11:21:12 -08:00
.gitignore Add updater and release automation 2025-12-28 13:49:44 -08:00
agents.md Add build quality mandate to agents.md 2026-03-04 15:43:03 -08:00
BUGFIX_mark_read_refresh.md Improve skip silence to avoid random word skipping - increased minimum to 800ms, padding to 300ms, reduced merge gap 2026-01-30 12:14:26 -08:00
BUGFIX_volume_jump.md Improve skip silence to avoid random word skipping - increased minimum to 800ms, padding to 300ms, reduced merge gap 2026-01-30 12:14:26 -08:00
build.bat fix: bundle Deno binary for yt-dlp support 2026-01-17 10:11:08 -08:00
build.md Update docs: split build guide and refresh README/agents 2026-02-18 12:07:11 -08:00
check_miniflux.py Fix slow playback start due to excessive cache prefetch 2026-01-31 08:03:34 -08:00
check_portable_db.py Fix slow playback start due to excessive cache prefetch 2026-01-31 08:03:34 -08:00
check_reg.py revert: rollback source code to v1.53.7 state 2026-01-06 22:12:48 -08:00
debug_mark_read.py Improve skip silence to avoid random word skipping - increased minimum to 800ms, padding to 300ms, reduced merge gap 2026-01-30 12:14:26 -08:00
FEATURE_remember_last_feed.md Improve skip silence to avoid random word skipping - increased minimum to 800ms, padding to 300ms, reduced merge gap 2026-01-30 12:14:26 -08:00
IMPROVEMENT_skip_silence.md Improve skip silence to avoid random word skipping - increased minimum to 800ms, padding to 300ms, reduced merge gap 2026-01-30 12:14:26 -08:00
main.py Fix Windows notification prerequisites (AppUserModelID + Start Menu shortcut) 2026-02-27 08:30:40 -08:00
main.spec Tighten PyInstaller package collection 2026-02-02 13:50:03 -08:00
npr_test.py fix: remove bbc.com from known_domains to fix article detection tests 2026-01-15 07:10:24 -08:00
README.md Add contact information for bugs and Telegram group 2026-02-22 13:49:11 -08:00
repro_check_supported.py revert: rollback source code to v1.53.7 state 2026-01-06 22:12:48 -08:00
repro_extract.py revert: rollback source code to v1.53.7 state 2026-01-06 22:12:48 -08:00
repro_extract_fixed.py revert: rollback source code to v1.53.7 state 2026-01-06 22:12:48 -08:00
repro_relocation.py Improve skip silence to avoid random word skipping - increased minimum to 800ms, padding to 300ms, reduced merge gap 2026-01-30 12:14:26 -08:00
repro_scroll.py Adjust refresh sound and startup 2026-01-12 20:04:58 -08:00
requirements.txt Release v1.56.1: Fix Youtube playback, Bluesky titles, and add Audio Detection 2026-01-08 11:46:06 -08:00
setup.bat Improve dependency checks, spec includes everything necessary for building now, and media tool detection 2025-12-19 10:49:17 -08:00
start_blindrss.bat Add silence skipping and detection with WebRTC VAD 2025-12-16 22:59:42 -08:00
update_helper.bat updater: refine logging and rollback behavior in update_helper.bat 2026-01-29 21:49:08 -08:00

README.md

BlindRSS

BlindRSS is a screen-reader-friendly desktop RSS and podcast app. It is built for fast feed reading and reliable audio playback.

What BlindRSS Does

  • Reads RSS/Atom feeds and plays podcast/video enclosures.
  • Supports local feeds plus hosted providers: Miniflux, Inoreader, The Old Reader, and BazQux.
  • Includes All/Unread/Read/Favorites views, plus mark read/unread and mark all read.
  • Extracts full article text when feeds only provide summaries.
  • Finds feeds from URLs and search providers (Apple Podcasts, gPodder, Feedly, NewsBlur, Reddit, Fediverse, Feedsearch, and local discovery).
  • Supports YouTube, Rumble, and Odysee URL discovery/media handling through yt-dlp and local resolvers.
  • Uses a local range-cache proxy for faster seeking and smoother VLC playback.
  • Casts to Chromecast, DLNA/UPnP, and AirPlay.
  • Supports tray controls, media keys, saved searches, and startup restore of your last selected feed/folder.
  • Supports Windows notifications for new articles with per-feed exclusions and per-refresh limits.
  • Includes a built-in updater that verifies SHA-256 and Authenticode before applying updates.

I accept pull requests!

If BlindRSS has helped you, feel free to submit pull requests with fixes or features you want, and I will consider them.

Quick Start

  1. Download the latest .zip asset from GitHub Releases.
  2. Extract the .zip anywhere.
  3. Run BlindRSS.exe.

Run From Python (Any OS)

  1. Install Python 3.12+.
  2. Install dependencies: pip install -r requirements.txt
  3. Run: python main.py

How to build

build.md. ##Submit bugs in issues, or join my Telegram group! (https://t.me/SerrebiProjects)