rndrSBC

Ultra-lightweight, high-performance native E-Paper operating platform designed for Single-Board Computers.

Why rndrSBC?

  • Chromium-Free: 0MB browser bloat. No headless Chrome, no WebKit, no X11.
  • Insanely Fast: Renders vector dashboards in 35ms–60ms (vs. 10–15 seconds on Chrome).
  • Zero Swap & Memory Thrashing: Runs in < 15MB RAM (ideal for Pi Zero W / Pi Zero 2W / Pi 3).
  • Responsive Canvas Engine: Resolution-independent vector layout with fractional split boxes and auto-scaling typography.
  • 100% Clean-Room Architecture: Fully standalone with modular display drivers and widget system.

Quick Start (Development / PC / Mac)

# 1. (Optional) Vendor the runtime deps for a fully-offline copy
python3 build_vendor_deps.py

# 2. Run single-pass render test
python3 main.py --once

Output is rendered directly to live_screen.png.

Run the web dashboard (any platform)

python3 main.py 8080          # foreground
python3 main.py --daemon 8080 # background, self-detaches (no sudo)

Raspberry Pi — no install.sh required

rndrSBC is relocatable: it anchors every path (config, previews, photo library) to its own folder, and it can load its Python deps straight from a vendored wheel bundle. So deployment is simply:

# Copy the project folder onto the Pi, then:
python3 main.py 8080

Optional, per-target dependency bundle (needs internet once, on the Pi):

python3 build_vendor_deps.py            # detects this machine's arch
# or for a Raspberry Pi explicitly:
python3 build_vendor_deps.py --platform aarch64   # 64-bit OS / Pi 4+ / Pi 5
python3 build_vendor_deps.py --platform armv7l    # 32-bit OS

The resulting vendor/deps/*.whl files let the platform run fully offline with zero pip installs. Skip this and rndrSBC will fall back to your system's packages (or create a private .venv on first run).

If you want rndrSBC to start at boot (optional), use the relocatable unit:

# edit the two placeholders in rndrSBC.service, then:
sudo cp rndrSBC.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now rndrSBC

A legacy install.sh is still included for compatibility, but it is no longer required.

Recent Additions (this build)

Physical Buttons (GPIO) — core/buttons.py

  • Wire three buttons to GPIO 17 / 27 / 22 (to GND), enabled in the dashboard.
  • NEXT cycles widgets, PREV goes back, TOGGLE-QUIET pauses/restarts refreshes.
  • Falls back gracefully when RPi.GPIO is absent (simulator / laptop / CI) — buttons are auto-disabled.

CalDAV + iCal Calendar — widgets/calendar/widget.py

  • Calendar widget now accepts a caldav config (URL + basic-auth user/password) in addition to public iCal feed URLs.
  • Fetches via HTTPS REPORT query, parses with the native ICS parser (no extra deps); per-date event-dot markers on the month grid.

Localization (i18n) — core/i18n.py

  • New language global setting (English, Español, Français, Deutsch, Italiano, Português, Nederlands, Türkçe).
  • Localizes the calendar weekday headers + agenda labels and the weather "Updated / Feels Like / Wind / Humidity" labels.
  • Add languages in core/i18n.py with three dicts (MONTHS, WEEKDAYS, LABELS).

Reflect-mode refresh — core/transitions.py + scheduler

  • refresh_mode: "auto" (default) uses dirty-rect partial refresh when the panel supports it, with a full-refresh recharge every 20 partials.
  • refresh_mode: "full" opt-out forces full-frame always (dashboard Display Transitions card).

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.12.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for thetaylormcrae from gravatar.com thetaylormcrae

Credits

Author: rndrSBC

License

MIT

Requires

Python >=3.9

Provides Extra

dev pi

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rndrsbc-0.1.0.tar.gz (1.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rndrsbc-0.1.0-py3-none-any.whl (1.4 MB view details)

Uploaded Python 3

File details

Details for the file rndrsbc-0.1.0.tar.gz.

File metadata

  • Download URL: rndrsbc-0.1.0.tar.gz
  • Upload date:
  • Size: 1.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for rndrsbc-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f3b524345d5beee9ac43a655cdb5dfa81665fa55d35f7e734af52fbbf529772a
MD5 e5985faeb4225ecaa7d249ac5162936e
BLAKE2b-256 40b0803a72dd1b4a3b74a0f7ebfe5517686f7c38c7636b6d4faddd54ab2b420b

See more details on using hashes here.

Provenance

The following attestation bundles were made for rndrsbc-0.1.0.tar.gz:

Publisher: publish.yml on thetaylormcrae/rndrsbc

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rndrsbc-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: rndrsbc-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for rndrsbc-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e078cdc1d92fae2904326259d227cb440d8e2e4f449e9448eded526f5e0c3091
MD5 6efadc3d85f50b9277e771e3980b2290
BLAKE2b-256 a5119e13747c3eb34bbee27e20b771ea359fa81f8e5aa81a0c7ea96655d55419

See more details on using hashes here.

Provenance

The following attestation bundles were made for rndrsbc-0.1.0-py3-none-any.whl:

Publisher: publish.yml on thetaylormcrae/rndrsbc

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.12.0

2 files

0.11.2

2 files

0.11.1

2 files

0.11.0

2 files

0.10.4

2 files

0.10.3

2 files

0.10.2

2 files

0.10.1

2 files

0.10.0

2 files

0.9.0

2 files

0.8.5

2 files

0.8.4

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.7

2 files

0.7.6

2 files

0.7.5

2 files

0.7.4

2 files

0.7.3

2 files

0.7.2

2 files

0.7.1

2 files

0.6.7

2 files

0.6.6

2 files

0.6.5

2 files

0.6.4

2 files

0.6.3

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.6

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page