bilihud 0.1.0__tar.gz

bilihud-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025, Locez
+
+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.

bilihud-0.1.0/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: bilihud
+Version: 0.1.0
+Summary: B站弹幕阅读器 - 一个可以在游戏全屏时显示弹幕的Qt应用程序
+Author-email: Locez <locez@locez.com>
+Maintainer-email: Locez <locez@locez.com>
+License: MIT
+Project-URL: bugs, https://github.com/locez/bilihud/issues
+Project-URL: changelog, https://github.com/locez/bilihud/blob/master/changelog.md
+Project-URL: homepage, https://github.com/locez/bilihud
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyQt6
+Requires-Dist: aiohttp
+Requires-Dist: qasync
+Requires-Dist: browser-cookie3
+Requires-Dist: brotli
+Requires-Dist: pure_protobuf
+Provides-Extra: test
+Requires-Dist: coverage; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: ruff; extra == "test"
+Requires-Dist: ty; extra == "test"
+Requires-Dist: ipdb; extra == "test"
+Dynamic: license-file
+
+# B站弹幕阅读器 (bilihud)
+
+![PyPI version](https://img.shields.io/pypi/v/bilihud.svg)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+一个基于PyQt6和blivedm的B站弹幕阅读器，可以在Linux KDE环境下全屏游戏时显示弹幕。
+
+> [!NOTE]
+> 本项目基于 **Vibe Coding**（氛围驱动编码）模式开发，旨在快速实现创意与功能。目前仅在有限环境下进行过测试，未做大量的严谨验证。如有 Bug，欢迎反馈！
+
+## 效果预览
+
+### 一般模式 (Normal)
+![Normal Mode](screenshots/normal.png)
+
+### 游戏穿透模式 (Pass-through)
+![Pass-through Mode](screenshots/passthrough.png)
+
+## 功能特点
+
+* 实时显示B站直播间弹幕
+* 半透明overlay窗口，可在游戏全屏时显示
+* 美观的UI界面，支持不同用户等级的颜色标识
+* 支持连接/断开直播间
+* 显示用户名、舰长/VIP标识
+* **注意：** 仅支持 **X11** 环境（推荐 KDE X11）。由于 Wayland 的安全机制，无法实现完美的鼠标穿透（Pass-through）模式，因此暂不支持纯 Wayland 环境。
+
+## 极速上手
+
+### 1. 安装
+
+```bash
+# 1. 克隆仓库
+git clone https://github.com/locez/bilihud.git
+cd bilihud
+
+# 2. 初始化子模块 (blivedm)
+git submodule update --init --recursive
+
+# 3. 环境配置与安装 (推荐使用 uv)
+# 安装 uv
+pip install uv
+
+# 创建虚拟环境并同步依赖
+uv sync
+
+# 激活环境
+source .venv/bin/activate
+```
+
+### 2. 启动
+
+```bash
+python -m src.bilihud.main
+```
+
+## 隐私说明 & 配置
+
+### 自动登录 (Cookies)
+
+为了提供完整的体验（如显示完整用户名、发送弹幕、显示舰长标识），**BiliHUD** 会尝试自动读取本地浏览器的 Bilibili 登录状态。
+
+*   **读取范围**: 程序仅读取 `.bilibili.com` 域下的 Cookies。
+*   **读取目的**: 获取 `SESSDATA` 和 `bili_jct` (CSRF Token) 仅用于与 Bilibili API 进行必要的身份验证。
+*   **支持浏览器**: Chrome, Edge, Firefox。
+*   **数据安全**: 您的 Cookies 仅在本地内存中使用，**绝不会**被发送到任何第三方服务器。
+
+### 手动配置 (可选)
+
+如果自动读取失败，或者您不希望程序读取浏览器 Cookies，可以在代码中手动传入 `SESSDATA`：
+
+```python
+from bilihud.danmaku_widget import DanmakuWidget
+
+# 在创建窗口时手动传入 SESSDATA
+danmaku_widget = DanmakuWidget(room_id=123456, sessdata="你的SESSDATA")
+```
+
+## 鸣谢
+
+* [blivedm](https://github.com/xfgryujk/blivedm) - B站直播弹幕协议库
+* [PyQt6](https://pypi.org/project/PyQt6/) - Python GUI框架
+* [qasync](https://github.com/CabbageDevelopment/qasync) - PyQt6与asyncio集成库

bilihud-0.1.0/README.md

@@ -0,0 +1,83 @@
+# B站弹幕阅读器 (bilihud)
+
+![PyPI version](https://img.shields.io/pypi/v/bilihud.svg)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+一个基于PyQt6和blivedm的B站弹幕阅读器，可以在Linux KDE环境下全屏游戏时显示弹幕。
+
+> [!NOTE]
+> 本项目基于 **Vibe Coding**（氛围驱动编码）模式开发，旨在快速实现创意与功能。目前仅在有限环境下进行过测试，未做大量的严谨验证。如有 Bug，欢迎反馈！
+
+## 效果预览
+
+### 一般模式 (Normal)
+![Normal Mode](screenshots/normal.png)
+
+### 游戏穿透模式 (Pass-through)
+![Pass-through Mode](screenshots/passthrough.png)
+
+## 功能特点
+
+* 实时显示B站直播间弹幕
+* 半透明overlay窗口，可在游戏全屏时显示
+* 美观的UI界面，支持不同用户等级的颜色标识
+* 支持连接/断开直播间
+* 显示用户名、舰长/VIP标识
+* **注意：** 仅支持 **X11** 环境（推荐 KDE X11）。由于 Wayland 的安全机制，无法实现完美的鼠标穿透（Pass-through）模式，因此暂不支持纯 Wayland 环境。
+
+## 极速上手
+
+### 1. 安装
+
+```bash
+# 1. 克隆仓库
+git clone https://github.com/locez/bilihud.git
+cd bilihud
+
+# 2. 初始化子模块 (blivedm)
+git submodule update --init --recursive
+
+# 3. 环境配置与安装 (推荐使用 uv)
+# 安装 uv
+pip install uv
+
+# 创建虚拟环境并同步依赖
+uv sync
+
+# 激活环境
+source .venv/bin/activate
+```
+
+### 2. 启动
+
+```bash
+python -m src.bilihud.main
+```
+
+## 隐私说明 & 配置
+
+### 自动登录 (Cookies)
+
+为了提供完整的体验（如显示完整用户名、发送弹幕、显示舰长标识），**BiliHUD** 会尝试自动读取本地浏览器的 Bilibili 登录状态。
+
+*   **读取范围**: 程序仅读取 `.bilibili.com` 域下的 Cookies。
+*   **读取目的**: 获取 `SESSDATA` 和 `bili_jct` (CSRF Token) 仅用于与 Bilibili API 进行必要的身份验证。
+*   **支持浏览器**: Chrome, Edge, Firefox。
+*   **数据安全**: 您的 Cookies 仅在本地内存中使用，**绝不会**被发送到任何第三方服务器。
+
+### 手动配置 (可选)
+
+如果自动读取失败，或者您不希望程序读取浏览器 Cookies，可以在代码中手动传入 `SESSDATA`：
+
+```python
+from bilihud.danmaku_widget import DanmakuWidget
+
+# 在创建窗口时手动传入 SESSDATA
+danmaku_widget = DanmakuWidget(room_id=123456, sessdata="你的SESSDATA")
+```
+
+## 鸣谢
+
+* [blivedm](https://github.com/xfgryujk/blivedm) - B站直播弹幕协议库
+* [PyQt6](https://pypi.org/project/PyQt6/) - Python GUI框架
+* [qasync](https://github.com/CabbageDevelopment/qasync) - PyQt6与asyncio集成库

bilihud-0.1.0/pyproject.toml

@@ -0,0 +1,73 @@
+[project]
+name = "bilihud"
+version = "0.1.0"
+description = "B站弹幕阅读器 - 一个可以在游戏全屏时显示弹幕的Qt应用程序"
+readme = "README.md"
+authors = [
+  {name = "Locez", email = "locez@locez.com"}
+]
+maintainers = [
+  {name = "Locez", email = "locez@locez.com"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: Chinese (Simplified)",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Video"
+]
+license = {text = "MIT"}
+dependencies = [
+  "PyQt6",
+  "aiohttp",
+  "qasync",
+  "browser-cookie3",
+
+  # for blivedm
+  "brotli",
+  "pure_protobuf"
+]
+requires-python = ">= 3.10"
+
+[project.optional-dependencies]
+test = [
+    "coverage",  # testing
+    "pytest",  # testing
+    "ruff",  # linting
+    "ty", # checking types
+    "ipdb", # debugging
+]
+
+[project.urls]
+bugs = "https://github.com/locez/bilihud/issues"
+changelog = "https://github.com/locez/bilihud/blob/master/changelog.md"
+homepage = "https://github.com/locez/bilihud"
+
+[project.scripts]
+bilihud = "bilihud.main:entry_point"
+
+[tool.ty]
+# All rules are enabled as "error" by default; no need to specify unless overriding.
+# Example override: relax a rule for the entire project (uncomment if needed).
+# rules.TY015 = "warn"  # For invalid-argument-type, warn instead of error.
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # Pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "UP",  # pyupgrade
+]
+
+[tool.uv]
+package = true

bilihud-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bilihud-0.1.0/src/bilihud/__init__.py

@@ -0,0 +1,12 @@
+"""Top-level package for bilihud."""
+
+__author__ = """Locez"""
+__email__ = 'locez@locez.com'
+__version__ = '0.1.0'
+
+# 为了确保能够找到vendor中的blivedm库，添加到sys.path
+import sys
+import os
+_vendor_path = os.path.join(os.path.dirname(__file__), '..', '..', 'vendor', 'blivedm')
+if _vendor_path not in sys.path:
+    sys.path.insert(0, _vendor_path)

bilihud-0.1.0/src/bilihud/__main__.py

@@ -0,0 +1,4 @@
+from .main import main
+
+if __name__ == "__main__":
+    main()

bilihud-0.1.0/src/bilihud/danmaku_client.py

@@ -0,0 +1,186 @@
+# -*- coding: utf-8 -*-
+import asyncio
+import http.cookies
+from typing import Optional, Callable
+import aiohttp
+import blivedm
+import blivedm.models.web as web_models
+
+
+class DanmakuClient:
+    """
+    弹幕客户端，用于获取B站直播弹幕
+    """
+
+    def __init__(self, room_id: int, sessdata: str = ''):
+        self.room_id = room_id
+        self.sessdata = sessdata
+        self.session: Optional[aiohttp.ClientSession] = None
+        self.client: Optional[blivedm.BLiveClient] = None
+        self.handler: Optional[DanmakuHandler] = None
+        self.on_danmaku_received: Optional[Callable[[web_models.DanmakuMessage], None]] = None
+        self.on_gift_received: Optional[Callable[[web_models.GiftMessage], None]] = None
+        self.on_interact_received: Optional[Callable[[web_models.InteractWordV2Message], None]] = None
+
+    def set_danmaku_callback(self, callback: Callable[[web_models.DanmakuMessage], None]):
+        """设置弹幕接收回调函数"""
+        self.on_danmaku_received = callback
+
+    def set_gift_callback(self, callback: Callable[[web_models.GiftMessage], None]):
+        """设置礼物接收回调函数"""
+        self.on_gift_received = callback
+
+    def set_interact_callback(self, callback: Callable[[web_models.InteractWordV2Message], None]):
+        """设置互动接收回调函数 (进房/关注)"""
+        self.on_interact_received = callback
+
+    async def start(self):
+        """在事件循环中启动弹幕客户端"""
+        # 初始化session
+        cookies = http.cookies.SimpleCookie()
+        
+        # 尝试从浏览器加载Cookies
+        browser_cookies = load_bilibili_cookies()
+        if browser_cookies:
+            # print("Successfully loaded cookies from browser")
+            # 将http.cookiejar.CookieJar转换为SimpleCookie或简单dict
+            for cookie in browser_cookies:
+                cookies[cookie.name] = cookie.value
+        
+        if self.sessdata:
+            cookies['SESSDATA'] = self.sessdata
+            
+        # 确保domain设置正确
+        if 'SESSDATA' in cookies:
+            cookies['SESSDATA']['domain'] = 'bilibili.com'
+
+        headers = {
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.0.0'
+        }
+        self.session = aiohttp.ClientSession(headers=headers)
+        self.session.cookie_jar.update_cookies(cookies)
+
+        # 创建客户端和处理器
+        self.client = blivedm.BLiveClient(self.room_id, session=self.session)
+        self.handler = DanmakuHandler()
+        self.handler.set_danmaku_client(self)
+        self.client.set_handler(self.handler)
+
+        loop = asyncio.get_event_loop()
+        loop.call_soon(self.client.start)
+        # 启动客户端
+        # self.client.start()
+        # await asyncio.sleep(0.1)  # 让出控制权以启动客户端
+
+    async def send_danmaku(self, message: str) -> tuple[bool, str]:
+        """发送弹幕"""
+        if not self.session or not message:
+            return False, "会话未初始化或消息为空"
+            
+        url = 'https://api.live.bilibili.com/msg/send'
+        
+        # 从cookie中获取csrf token (bili_jct)
+        csrf_token = ''
+        for cookie in self.session.cookie_jar:
+            if cookie.key == 'bili_jct':
+                csrf_token = cookie.value
+                break
+                
+        if not csrf_token:
+            # print("Error: No csrf_token found in cookies")
+            return False, "未找到CSRF Token，请重新连接或检查Cookie"
+            
+        data = {
+            'bubble': '0',
+            'msg': message,
+            'color': '16777215',
+            'mode': '1',
+            'fontsize': '25',
+            'rnd': str(int(asyncio.get_event_loop().time())),
+            'roomid': self.room_id,
+            'csrf': csrf_token,
+            'csrf_token': csrf_token,
+        }
+        
+        try:
+            async with self.session.post(url, data=data) as res:
+                if res.status != 200:
+                    print(f"Send danmaku HTTP error: {res.status}")
+                    return False, f"HTTP错误: {res.status}"
+                json_data = await res.json()
+                if json_data['code'] == 0:
+                    return True, "发送成功"
+                else:
+                    print(f"Send danmaku failed: {json_data['message']}")
+                    return False, f"发送失败: {json_data['message']}"
+        except Exception as e:
+            print(f"Send danmaku exception: {e}")
+            return False, f"发送异常: {str(e)}"
+
+    async def stop(self):
+        """停止弹幕客户端"""
+        if self.client:
+            await self.client.stop_and_close()
+        if self.session:
+            await self.session.close()
+
+
+class DanmakuHandler(blivedm.BaseHandler):
+    """弹幕处理器"""
+
+    def __init__(self):
+        super().__init__()
+        self.danmaku_client: Optional[DanmakuClient] = None
+
+    def set_danmaku_client(self, client: DanmakuClient):
+        self.danmaku_client = client
+
+    def _on_danmaku(self, client: blivedm.BLiveClient, message: web_models.DanmakuMessage):
+        """处理弹幕消息"""
+        if self.danmaku_client and self.danmaku_client.on_danmaku_received:
+            self.danmaku_client.on_danmaku_received(message)
+
+    def _on_gift(self, client: blivedm.BLiveClient, message: web_models.GiftMessage):
+        """处理礼物消息"""
+        if self.danmaku_client and self.danmaku_client.on_gift_received:
+            self.danmaku_client.on_gift_received(message)
+            
+    def _on_interact_word_v2(self, client: blivedm.BLiveClient, message: web_models.InteractWordV2Message):
+        """处理进入房间/关注"""
+        if self.danmaku_client and self.danmaku_client.on_interact_received:
+            self.danmaku_client.on_interact_received(message)
+
+    def _on_super_chat(self, client: blivedm.BLiveClient, message: web_models.SuperChatMessage):
+        """处理醒目留言"""
+        # 可以在这里处理醒目留言
+        pass
+
+
+def load_bilibili_cookies():
+    """尝试从浏览器加载B站Cookies"""
+    try:
+        import browser_cookie3
+        # 尝试从Chrome加载
+        # print("Attempting to load cookies from Chrome...")
+        cj = browser_cookie3.chrome(domain_name='.bilibili.com')
+        return cj
+    except Exception as e:
+        print(f"Chrome cookies failed: {e}")
+        try:
+            import browser_cookie3
+            # 尝试从Edge加载
+            cj = browser_cookie3.edge(domain_name='.bilibili.com')
+            return cj
+        except Exception as e:
+            print(f"Edge cookies failed: {e}")
+            try:
+                import browser_cookie3
+                # 尝试从Firefox加载
+                cj = browser_cookie3.firefox(domain_name='.bilibili.com')
+                return cj
+            except Exception as e:
+                print(f"Firefox cookies failed: {e}")
+                return None
+
+
+