Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Quiet hours: time windows with no or fewer screen refreshes (M4)

Đang mở
#299 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
python
Lĩnh vực
backend

Hướng nghiên cứu

Start with src/paperpi/scheduler.py and src/paperpi/config.py, then read the existing scheduler tests that use a pretend clock. Trace how scheduled screen writes and clean_every work before deciding how quiet windows affect them. Done means multiple daily or weekly windows, including ones that cross midnight, limit screen writes as specified, and are applied on config reload; the open behavior questions need answers first.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Idea from txoof (2026-10-23), after the 9.7" ran 21 hours as a service: fewer screen refreshes at times nobody looks, to spare the screen.

What

Quiet hours: one or more time windows in which the screen doesn't change, or changes only once or twice an hour.

Sketch:

[[display.quiet]]
from = "23:00"
to = "07:00"
writes_per_hour = 0      # 0: no screen changes; 1 or 2: at :00 (and :30)

[[display.quiet]]
from = "13:00"
to = "14:00"
days = ["sat", "sun"]    # optional; default every day
writes_per_hour = 1
  • Several windows; a window may cross midnight; the Pi's local time, so summer and winter time are handled.
  • During a window only screen writes are limited; plugins keep fetching (see open point 3), so the first picture after the window is current.
  • The hourly full clear (clean_every) is skipped during a window and done once at its end.
  • With 1 or 2 writes per hour, each write shows the plugin that is current at that moment.
  • Health check: no change needed (healthy doesn't require a recent screen write).
  • Applied at config reload. The web form (M5) comes later, separately.

Open points (ask txoof one at a time)

  1. With 0 writes the last picture stays, possibly a clock with the wrong time. At the start of a window: show "Quiet until 07:00", go blank, or keep the last picture?
  2. May a music plugin that starts playing break through quiet hours (as it interrupts other plugins now, #284)?
  3. Do plugins also stop fetching in a window (fewer network requests), or only stop drawing?

Size

About 400–600 lines in one PR: config, scheduler, tests with the pretend clock, docs.

Area

core (src/paperpi/scheduler.py, src/paperpi/config.py), docs.

Ngôn ngữ chính
Python
Star
205
Fork
17
Merge trung bình
4 giờ 8 phút
Pull request đã merge (30 ngày)
72

Chuẩn bị môi trường

  • Không có Dockerfile hay tệp Docker Compose
  • Có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của txoof/PaperPi

Tất cả issue của txoof/PaperPi

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.