Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン
#299 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
python
領域
backend

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
Python
スター
205
フォーク
17
平均マージ
3時間 55分
マージ済み PR(30日)
77

環境構築

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートあり
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

txoof/PaperPi のほかの issue

txoof/PaperPi の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。