nonebot-plugin-picstatus-re 2.3.0__tar.gz

nonebot_plugin_picstatus_re-2.3.0/.env.example

@@ -0,0 +1,187 @@
+# ####################
+# 以下配置项【均为可选】，请按需添加
+# 除非特别说明，示例配置中的值均为插件该配置项的默认值
+# ####################
+
+# ====================
+# 全局设置
+
+# 用来测试访问网址时的代理（默认为空）
+PROXY="http://127.0.0.1:7890"
+
+# ====================
+# 行为设置
+
+# 要使用的图片模板
+# 目前只有 default 可用
+# 关于模板的特定配置请见最下方
+PS_TEMPLATE=default
+
+# 触发插件功能的指令列表
+PS_COMMAND=["状态","status"]
+
+# 是否只能由 SUPERUSER 触发指令
+PS_ONLY_SU=False
+
+# 触发指令是否需要 @Bot
+PS_NEED_AT=False
+
+# 是否回复目标用户
+# 使用 QQ 官方机器人时需要关闭此项（官方尚未支持回复），否则可能导致报错！
+PS_REPLY_TARGET=True
+
+# 请求头像等其他 URL 时的超时时间（秒）
+PS_REQ_TIMEOUT=10
+
+# ====================
+# 全局个性化设置
+
+# 图片背景图来源
+# 图片来源列表：
+#   - "local": 本地图片
+#   - "none": 无背景图
+PS_BG_PROVIDER=local
+
+# 背景图预载数量（最低可填 0）
+PS_BG_PRELOAD_COUNT=2
+
+# 本地背景图来源 ("local") 使用的图片文件 / 文件夹路径（默认为插件自带背景图）
+# 如路径不存在，会 fallback 到插件自带默认背景图
+PS_BG_LOCAL_PATH=
+
+# 当获取 Bot 头像失败时使用的默认头像路径（默认为插件自带头像）
+PS_DEFAULT_AVATAR=
+
+# ====================
+# 数据收集设置
+
+# == 基础设置 ==
+
+# PeriodicCollector 的调用间隔，单位秒
+PS_COLLECT_INTERVAL=5
+
+# PeriodicCollector 中 deque 的默认大小
+PS_DEFAULT_COLLECT_CACHE_SIZE=1
+
+# 设置特定 PeriodicCollector 中 deque 的大小，{ [name: string]: number }，
+PS_COLLECT_CACHE_SIZE={}
+
+# == header ==
+
+# 使用 .env 中配置的 NICKNAME 作为图片上的 Bot 昵称
+PS_USE_ENV_NICK=False
+
+# 仅显示当前 Bot
+PS_SHOW_CURRENT_BOT_ONLY=False
+
+# 是否对适配器为 OneBot V11 的 Bot 调用 get_status 获取收发消息数
+PS_OB_V11_USE_GET_STATUS=True
+
+# 是否使用 message_sent 事件（OneBot V11），或 user_id 为自身的消息事件统计发送消息数
+# 为 False 时全局禁用，为 True 时全局启用，
+# 为适配器名称列表（如 ["OneBot V11", "Telegram"]）仅对指定的适配器启用
+PS_COUNT_MESSAGE_SENT_EVENT=False
+
+# 是否在 Bot 断开链接时清空收发消息计数
+PS_DISCONNECT_RESET_COUNTER=True
+
+# == disk ==
+
+# 分区列表里忽略的盘符（挂载点）
+# 使用正则表达式匹配
+# 由于配置项使用JSON解析，所以需要使用双反斜杠转义，
+# 如："sda\\d" 解析为 sda\d（代表 sda<一位阿拉伯数字>）；
+#     "C:\\\\Windows" 解析为 C:\\Windows（代表 C:\Windows）
+PS_IGNORE_PARTS=[]
+
+# 忽略获取容量状态失败的磁盘分区
+PS_IGNORE_BAD_PARTS=False
+
+# 是否排序分区列表（按照已用大小比例倒序）
+PS_SORT_PARTS=True
+
+# 是否反转分区列表排序
+PS_SORT_PARTS_REVERSE=False
+
+# 磁盘 IO 统计列表中忽略的磁盘名
+# 使用正则表达式匹配（注意事项同上）
+PS_IGNORE_DISK_IOS=["^(loop|zram)\\d*$"]
+
+# 是否忽略 IO 都为 0B/s 的磁盘
+PS_IGNORE_NO_IO_DISK=False
+
+# 是否排序磁盘 IO 统计列表（按照读写速度总和倒序）
+PS_SORT_DISK_IOS=True
+
+# == network ==
+
+# 网速列表中忽略的网络名称
+# 使用正则表达式匹配（注意事项同上）
+PS_IGNORE_NETS=[r"^lo(op)?\\d*$|^(Loopback|本地连接)"]
+
+# 是否忽略上下行都为 0B/s 的网卡
+PS_IGNORE_0B_NET=False
+
+# 是否排序网速列表（按照上下行速度总和倒序）
+PS_SORT_NETS=True
+
+# 需要进行测试响应速度的网址列表
+# 字段说明：
+#   - name: 显示名称
+#   - url: 测试网址
+#   - use_proxy: 是否使用插件配置中的代理访问（可不填，默认为 false）
+PS_TEST_SITES='
+[
+    {"name": "百度", "url": "https://www.baidu.com/"},
+    {"name": "谷歌", "url": "https://www.google.com/", "use_proxy": true}
+]
+'
+
+# 是否将测试网址的结果排序（按照响应时间正序）
+PS_SORT_SITES=True
+
+# 网址测试访问时的超时时间（秒）
+PS_TEST_TIMEOUT=3
+
+# == process ==
+
+# 进程列表的最大项目数量
+PS_PROC_LEN=5
+
+# 要忽略的进程名
+# 使用正则表达式匹配（注意事项同上）
+PS_IGNORE_PROCS=[]
+
+# 进程列表的排序方式
+# 可选：cpu、mem
+PS_PROC_SORT_BY=cpu
+
+# 是否将进程 CPU 占用率显示为类似 Windows 任务管理器的百分比（最高 100%）
+# 例：当你的 CPU 总共有 4 线程时，如果该进程吃满了两个线程，
+# Linux 会显示为 200%（每个线程算 100%），而 Windows 会显示为 50%（总占用率算 100%）
+PS_PROC_CPU_MAX_100P=False
+
+# ====================
+# default 模板特定配置
+
+# 图片中渲染的组件列表及其排列顺序
+# 默认启用全部组件
+# 组件介绍：
+#   - "header": 已连接的 Bot 信息、NoneBot 运行时间、系统运行时间
+#   - "cpu_mem": CPU、MEM、SWAP 使用率圆环图
+#   - "disk": 分区占用情况、磁盘 IO 情况
+#   - "network": 网络 IO 情况、网络响应速度测试
+#   - "process": 进程 CPU、MEM 占用情况
+#   - "footer": NoneBot 与 PicStatus 版本、当前时间、Python 实现及版本、系统名称及架构
+PS_DEFAULT_COMPONENTS=["header", "cpu_mem", "disk", "network", "process", "footer"]
+
+
+
+# 输出的图片格式
+# 可选：jpeg、png
+PS_DEFAULT_PIC_FORMAT=jpeg
+
+# 是否使用后台收集器
+# 如使用，插件将会在后台以指定间隔获取部分服务器信息
+# 如不使用，插件仅会在指令被调用时获取全部信息
+PS_DEFAULT_USE_PERIODIC=True

nonebot_plugin_picstatus_re-2.3.0/.github/workflows/pypi-publish.yml

@@ -0,0 +1,34 @@
+name: Publish Python 🐍 distributions 📦 to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build-n-publish:
+    name: Use uv to Build and publish Python 🐍 distributions 📦 to PyPI
+    runs-on: ubuntu-latest
+
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@master
+        with:
+          submodules: true
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: 'Set up Python'
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: 'pyproject.toml'
+
+      - name: Build and Publish distribution 📦 to PyPI
+        run: |
+          uv build
+          uv publish

nonebot_plugin_picstatus_re-2.3.0/.gitignore

@@ -0,0 +1,9 @@
+/.vscode/
+/.idea/
+/.run/
+/venv/
+/testnb2/
+.pdm-python
+build/
+__pycache__
+/nonebot_plugin_picstatus/res/picstatus-debug.html

nonebot_plugin_picstatus_re-2.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yuexps
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nonebot_plugin_picstatus_re-2.3.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-picstatus-re
+Version: 2.3.0
+Summary: A NoneBot2 plugin generates a picture which shows the status of current device
+Project-URL: homepage, https://github.com/yuexps/nonebot-plugin-picstatus-re
+Author-email: yuexps <yuexps@qq.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: <4.0,>=3.10
+Requires-Dist: anyio>=4.10.0
+Requires-Dist: cookit[jinja,loguru,nonebot-localstore,pydantic]>=0.13.3
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: nonebot-plugin-alconna>=0.59.4
+Requires-Dist: nonebot-plugin-apscheduler>=0.5.0
+Requires-Dist: nonebot-plugin-htmlkit
+Requires-Dist: nonebot-plugin-localstore>=0.7.4
+Requires-Dist: nonebot-plugin-uninfo>=0.9.0
+Requires-Dist: nonebot2>=2.4.3
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: py-cpuinfo>=9.0.0
+Requires-Dist: taskgroup>=0.2.2; python_version < '3.11'
+Requires-Dist: yarl>=1.20.1
+Description-Content-Type: text/markdown
+
+<!-- markdownlint-disable MD033 MD036 MD041 -->
+
+<div align="center">
+
+# NoneBot-Plugin-PicStatus-Re
+
+以精美的卡片图片形式展示 NoneBot2 运行设备的系统状态（CPU、内存、磁盘、网速、进程等信息），采用 [nonebot/plugin-htmlkit](https://github.com/nonebot/plugin-htmlkit) 将 HTML 渲染为图片。
+
+</div>
+
+## 安装
+
+```bash
+# 使用 nb-cli 安装（推荐）
+nb plugin install nonebot-plugin-picstatus-re
+
+# 或使用 pip 安装
+pip install nonebot-plugin-picstatus-re
+```
+使用包管理器安装时，需在项目的 `pyproject.toml` 中的 `[tool.nonebot]` 部分的 `plugins` 列表中手动追加 `"nonebot_plugin_picstatus_re"`。
+
+## 使用与配置
+
+- **触发指令**：`状态` / `status`（可在配置中修改）
+- **参数配置**：参数均在项目的 `.env.*` 文件中配置，完整说明请参考 **[.env.example](.env.example)**。
+
+## 鸣谢
+
+- [nonebot-plugin-picstatus](https://github.com/lgc-NB2Dev/nonebot-plugin-picstatus) (原版插件)
+- [nonebot/plugin-alconna](https://github.com/nonebot/plugin-alconna) (命令解析)
+- [noneplugin/nonebot-plugin-userinfo](https://github.com/noneplugin/nonebot-plugin-userinfo) (用户信息获取)
+- [nonebot/plugin-htmlkit](https://github.com/nonebot/plugin-htmlkit) (HTML 渲染)
+- [LoliApi](https://www.loliapi.com/acg/pe/) (图片源)

nonebot_plugin_picstatus_re-2.3.0/README.md

@@ -0,0 +1,33 @@
+<!-- markdownlint-disable MD033 MD036 MD041 -->
+
+<div align="center">
+
+# NoneBot-Plugin-PicStatus-Re
+
+以精美的卡片图片形式展示 NoneBot2 运行设备的系统状态（CPU、内存、磁盘、网速、进程等信息），采用 [nonebot/plugin-htmlkit](https://github.com/nonebot/plugin-htmlkit) 将 HTML 渲染为图片。
+
+</div>
+
+## 安装
+
+```bash
+# 使用 nb-cli 安装（推荐）
+nb plugin install nonebot-plugin-picstatus-re
+
+# 或使用 pip 安装
+pip install nonebot-plugin-picstatus-re
+```
+使用包管理器安装时，需在项目的 `pyproject.toml` 中的 `[tool.nonebot]` 部分的 `plugins` 列表中手动追加 `"nonebot_plugin_picstatus_re"`。
+
+## 使用与配置
+
+- **触发指令**：`状态` / `status`（可在配置中修改）
+- **参数配置**：参数均在项目的 `.env.*` 文件中配置，完整说明请参考 **[.env.example](.env.example)**。
+
+## 鸣谢
+
+- [nonebot-plugin-picstatus](https://github.com/lgc-NB2Dev/nonebot-plugin-picstatus) (原版插件)
+- [nonebot/plugin-alconna](https://github.com/nonebot/plugin-alconna) (命令解析)
+- [noneplugin/nonebot-plugin-userinfo](https://github.com/noneplugin/nonebot-plugin-userinfo) (用户信息获取)
+- [nonebot/plugin-htmlkit](https://github.com/nonebot/plugin-htmlkit) (HTML 渲染)
+- [LoliApi](https://www.loliapi.com/acg/pe/) (图片源)

nonebot_plugin_picstatus_re-2.3.0/nonebot_plugin_picstatus_re/__init__.py

@@ -0,0 +1,67 @@
+# ruff: noqa: E402
+
+from nonebot import get_driver, require
+from nonebot.plugin import PluginMetadata, inherit_supported_adapters
+
+require("nonebot_plugin_apscheduler")
+require("nonebot_plugin_alconna")
+require("nonebot_plugin_uninfo")
+require("nonebot_plugin_localstore")
+
+from . import __main__ as __main__, misc_statistics as misc_statistics
+from .bg_provider import bg_preloader
+from .collectors import (
+    enable_collectors,
+    load_builtin_collectors,
+    registered_collectors,
+)
+from .config import ConfigModel, config
+from .templates import load_builtin_templates, loaded_templates
+
+driver = get_driver()
+
+
+# lazy load builtin templates and collectors
+@driver.on_startup
+async def _():
+    if config.ps_template not in loaded_templates:
+        load_builtin_templates()
+    current_template = loaded_templates.get(config.ps_template)
+    if current_template is None:
+        raise ValueError(f"Template {config.ps_template} not found")
+
+    if (current_template.collectors is None) or any(
+        (x not in registered_collectors) for x in current_template.collectors
+    ):
+        load_builtin_collectors()
+
+    collectors = (
+        set(registered_collectors)
+        if current_template.collectors is None
+        else current_template.collectors
+    )
+    await enable_collectors(*collectors)
+
+    bg_preloader.start_preload()
+
+
+usage = f"指令：{' / '.join(config.ps_command)}"
+if config.ps_need_at:
+    usage += "\n注意：使用指令时需要@机器人"
+if config.ps_only_su:
+    usage += "\n注意：仅SuperUser可以使用此指令"
+
+__version__ = "2.3.0"
+__plugin_meta__ = PluginMetadata(
+    name="PicStatus-Re",
+    description="以图片形式显示当前设备的运行状态",
+    usage=usage,
+    type="application",
+    homepage="https://github.com/yuexps/nonebot-plugin-picstatus-re",
+    config=ConfigModel,
+    supported_adapters=inherit_supported_adapters(
+        "nonebot_plugin_alconna",
+        "nonebot_plugin_uninfo",
+    ),
+    extra={"License": "MIT", "Author": "yuexps"},
+)

nonebot_plugin_picstatus_re-2.3.0/nonebot_plugin_picstatus_re/__main__.py

@@ -0,0 +1,57 @@
+import asyncio
+
+from nonebot import logger, on_command
+from nonebot.adapters import Bot as BaseBot, Event as BaseEvent, Message as BaseMessage
+from nonebot.matcher import current_bot, current_event, current_matcher
+from nonebot.params import CommandArg
+from nonebot.permission import SUPERUSER
+from nonebot.rule import Rule, to_me
+from nonebot.typing import T_State
+from nonebot_plugin_alconna.uniseg import UniMessage
+
+from .bg_provider import bg_preloader
+from .collectors import collect_all
+from .config import config
+from .misc_statistics import bot_avatar_cache, bot_info_cache, cache_bot_avatar
+from .templates import render_current_template
+
+
+def check_empty_arg_rule(arg: BaseMessage = CommandArg()):
+    return not arg.extract_plain_text()
+
+
+def trigger_rule():
+    rule = Rule(check_empty_arg_rule)
+    if config.ps_need_at:
+        rule &= to_me()
+    return rule
+
+
+_cmd, *_alias = config.ps_command
+stat_matcher = on_command(
+    _cmd,
+    aliases=set(_alias),
+    rule=trigger_rule(),
+    permission=SUPERUSER if config.ps_only_su else None,
+)
+
+
+@stat_matcher.handle()
+async def _(bot: BaseBot, event: BaseEvent, state: T_State):
+    if (
+        (bot.self_id not in bot_avatar_cache)
+        and (info := bot_info_cache.get(bot.self_id))
+        and info.avatar
+    ):
+        await cache_bot_avatar(info.avatar, bot, event, state)
+
+    try:
+        bg, collected = await asyncio.gather(bg_preloader.get(), collect_all())
+        ret = await render_current_template(collected=collected, bg=bg)
+    except Exception:
+        logger.exception("获取运行状态图失败")
+        await UniMessage("获取运行状态图片失败，请检查后台输出").send(
+            reply_to=config.ps_reply_target,
+        )
+    else:
+        await UniMessage.image(raw=ret).send(reply_to=config.ps_reply_target)

nonebot_plugin_picstatus_re-2.3.0/nonebot_plugin_picstatus_re/bg_provider.py

@@ -0,0 +1,218 @@
+import asyncio as aio
+import mimetypes
+import random
+import sys
+import time
+from collections.abc import AsyncIterable
+from pathlib import Path
+from typing import NamedTuple, TypeAlias
+
+from cookit.common import race
+from cookit.loguru import warning_suppress
+from nonebot import get_driver, logger
+
+from .config import BG_PRELOAD_CACHE_DIR, DEFAULT_BG_PATH, ASSETS_PATH, config
+
+if sys.version_info >= (3, 11):
+    from asyncio.taskgroups import TaskGroup
+else:
+    from taskgroup import TaskGroup
+
+
+class BgBytesData(NamedTuple):
+    data: bytes | None
+    mime: str
+
+
+class BgFileData(NamedTuple):
+    path: Path | None
+    mime: str
+
+
+BgData: TypeAlias = BgBytesData | BgFileData
+DEFAULT_MIME = "application/octet-stream"
+
+
+def get_bg_files() -> list["Path"]:
+    if not config.ps_bg_local_path.exists():
+        logger.warning("Custom background path does not exist, fallback to default")
+        return [DEFAULT_BG_PATH]
+    if config.ps_bg_local_path.is_file():
+        return [config.ps_bg_local_path]
+
+    if config.ps_bg_local_path == ASSETS_PATH:
+        files = [x for x in config.ps_bg_local_path.glob("default_bg_*.webp") if x.is_file()]
+    else:
+        files = [
+            x for x in config.ps_bg_local_path.glob("*")
+            if x.is_file() and x.name != "default_avatar.webp"
+        ]
+    if not files:
+        logger.warning("Custom background dir has no file in it, fallback to default")
+        return [DEFAULT_BG_PATH]
+    return files
+
+
+BG_FILES = get_bg_files()
+
+
+def refresh_bg_files():
+    global BG_FILES
+    BG_FILES = get_bg_files()
+
+
+async def local(num: int) -> AsyncIterable[BgData]:
+    files = random.sample(BG_FILES, num)
+    for x in files:
+        yield BgFileData(
+            x,
+            mimetypes.guess_type(x)[0] or DEFAULT_MIME,
+        )
+
+
+async def none(num: int) -> AsyncIterable[BgData]:
+    for _ in range(num):
+        yield BgBytesData(None, DEFAULT_MIME)
+
+
+async def fetch_bg(num: int) -> AsyncIterable[BgData]:
+    provider = none if config.ps_bg_provider == "none" else local
+    async for x in provider(num):
+        yield x
+
+
+def cache_bg(bg: BgBytesData):
+    if not bg.data:
+        return BgFileData(None, bg.mime)
+    BG_PRELOAD_CACHE_DIR.mkdir(parents=True, exist_ok=True)
+    path = BG_PRELOAD_CACHE_DIR / f"{time.time_ns()}.{bg.mime.split('/')[-1]}"
+    path.write_bytes(bg.data)
+    return BgFileData(path, bg.mime)
+
+
+def read_cached_bg_file(bg: BgFileData) -> BgBytesData | None:
+    if not bg.path:
+        return BgBytesData(None, bg.mime)
+    with warning_suppress("Failed to read cached file"):
+        data = bg.path.read_bytes()
+        if bg.path.is_relative_to(BG_PRELOAD_CACHE_DIR):
+            with warning_suppress("Failed to unlink cached file"):
+                bg.path.unlink()
+        return BgBytesData(data, bg.mime)
+    return None
+
+
+async def get_one_fallback() -> BgBytesData:
+    with warning_suppress("Failed to get local bg file, fallback to none"):
+        async for x in local(1):
+            if bg := read_cached_bg_file(x):
+                return bg
+    logger.warning("Failed to read local bg file, fallback to none")
+    return BgBytesData(None, DEFAULT_MIME)
+
+
+class BgPreloader:
+    def __init__(self, preload_count: int):
+        self.preload_count = preload_count
+        self.background_queue = aio.Queue[BgData]()
+        self.current_load_task_main: aio.Task | None = None
+        self.consumed_in_loading: bool = False
+        self.image_got_signal = aio.Event()
+        self.fire_tasks: set[aio.Task] = set()
+
+    async def preload_task(
+        self,
+        count: int,
+        fire: bool = False,
+        fire_done_signal: aio.Event | None = None,
+    ):
+        logger.debug(f"Preload task started, will preload {count} images, {fire=}")
+        try:
+            async for x in fetch_bg(count):
+                logger.debug("Got one image")
+                if self.preload_count > 0 or (
+                    fire_done_signal and fire_done_signal.is_set()
+                ):
+                    x = cache_bg(x) if isinstance(x, BgBytesData) else x
+                await self.background_queue.put(x)
+                self.image_got_signal.set()
+                self.image_got_signal.clear()
+        except Exception:
+            logger.exception("Unexpected error occurred in preload task")
+        else:
+            logger.debug("Preload task finished")
+
+        if fire:
+            return
+        if (
+            self.consumed_in_loading
+            or self.background_queue.qsize() < self.preload_count
+        ):
+            self.consumed_in_loading = False
+            self.start_preload()
+        else:
+            self.current_load_task_main = None
+
+    def start_preload(self, force: bool = False):
+        count = self.preload_count - self.background_queue.qsize()
+        if count <= 0 and not force:
+            logger.debug(
+                "Current background queue size meets preload count, skip preload",
+            )
+            return
+        task = aio.create_task(self.preload_task(count))
+        self.current_load_task_main = task
+
+    def set_defer_preload(self):
+        if self.current_load_task_main:
+            logger.debug("Main preload task already running, set flag")
+            self.consumed_in_loading = True
+        else:
+            self.start_preload()
+
+    async def _get_on_fire(self) -> BgBytesData:
+        task_done_signal = aio.Event()
+        fire_task = aio.create_task(
+            self.preload_task(1, fire=True, fire_done_signal=task_done_signal),
+        )
+        fire_task.add_done_callback(lambda _: task_done_signal.set())
+        fire_task.add_done_callback(lambda _: self.fire_tasks.discard(fire_task))
+        self.fire_tasks.add(fire_task)
+        try:
+            await race(
+                task_done_signal.wait(),
+                aio.sleep(15),
+            )
+        finally:
+            task_done_signal.set()
+
+        if not self.background_queue.empty():
+            bg = await self.background_queue.get()
+            self.set_defer_preload()
+            if (not isinstance(bg, BgFileData)) or (bg := read_cached_bg_file(bg)):
+                return bg
+
+        logger.error("Unable to get an background image, falling back to local")
+        return await get_one_fallback()
+
+    async def get(self) -> BgBytesData:
+        self.set_defer_preload()
+
+        while not self.background_queue.empty():
+            bg = await self.background_queue.get()
+            self.set_defer_preload()
+            if (not isinstance(bg, BgFileData)) or (bg := read_cached_bg_file(bg)):
+                return bg
+
+        return await self._get_on_fire()
+
+
+bg_preloader = BgPreloader(config.ps_bg_preload_count)
+
+driver = get_driver()
+
+
+@driver.on_shutdown
+async def _():
+    for t in bg_preloader.fire_tasks:
+        t.cancel()