serrebi/BlindRSS
1
15
Fork 0
mirror of https://github.com/serrebidev/BlindRSS.git synced 2026-05-31 05:25:54 -07:00
Code Issues Projects Releases 21 Packages Wiki Activity
A vibed accessible, modern RSS client for the blind
562 commits 2 branches 215 tags 4.4 MiB
  • Python 97.4%
  • Batchfile 1.7%
  • Shell 0.9%
Find a file
Exact
admin 81d879db78 Release v1.63.52
2026-05-29 14:54:28 -07:00
.github/workflows @ 2026-05-29 14:48:59 -07:00
assets Add accessible mac UI and cross-platform build pipeline 2026-04-15 12:04:16 -07:00
core Release v1.63.52 2026-05-29 14:54:28 -07:00
gui @ 2026-05-29 14:48:59 -07:00
hooks refactor(playback_state): centralize lock-skipping writes 2026-01-04 19:34:23 +01:00
providers @ 2026-05-29 14:48:59 -07:00
sounds fix: NPR feed, add sounds, cleanup boilerplate, fix accessibility 2026-01-06 11:43:32 -08:00
tests @ 2026-05-29 14:48:59 -07:00
tools Drop Linux packaging and workflow builds 2026-04-15 16:32:39 -07:00
.gitignore fix: force startup refresh and gate debug logs 2026-05-18 19:58:14 -07:00
agents.md @ 2026-05-29 14:48:59 -07: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 @ 2026-05-29 07:40:15 -07:00
build.md @ 2026-05-29 14:48:59 -07:00
build.sh @ 2026-05-29 07:40:15 -07: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
conftest.py Fix Windows updater running-app handoff 2026-05-21 12:58:01 -07: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: force startup refresh and gate debug logs 2026-05-18 19:58:14 -07:00
main.spec @ 2026-05-29 14:48:59 -07:00
npr_test.py fix: remove bbc.com from known_domains to fix article detection tests 2026-01-15 07:10:24 -08:00
portable.spec @ 2026-05-29 14:48:59 -07:00
pytest.ini fix: force startup refresh and gate debug logs 2026-05-18 19:58:14 -07:00
README.md docs: require Python 3.14 for builds 2026-05-18 20:05:52 -07: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 Fix updater window and article shortcuts 2026-05-25 11:36:00 -07:00
update_helper.sh @ 2026-05-29 14:48:59 -07: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.14.
  2. Install dependencies: pip install -r requirements.txt
  3. Run: python main.py

Debug Logging

When debug mode is enabled in Settings, BlindRSS writes a rotating debug log named blindrss.log beside the active config/data files. The log captures DEBUG and above. With debug mode disabled, BlindRSS does not create or attach this file log.

How to build

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