emby

Integrate with Emby Server API to manage media libraries, users, playback, live TV, devices, and encoding settings through comprehensive endpoints.

Emby Server API Skill

Configuration

配置参数位于 emby.py 文件顶部:

BASE_URL = "https://emby.example.com/emby"  # 修改为你的Emby服务器地址
API_KEY = "652436b1ffa84d9a85f579eeb34b87aa"     # 修改为你的API Key

使用方式

导入 emby 模块并调用相应函数:

from emby import get_items, get_user_by_id, download_item_image

返回值类型

• JSON返回: 大多数API调用返回 Dict (字典)
• Stream返回: 图片、视频、音频下载等返回 Response 对象或 bytes

Stream 类型函数 (返回 Response)

函数	用途
get_item_image()	获取媒体项图片
download_item_image()	下载媒体项图片到文件或返回bytes
get_video_stream_url()	获取视频流地址
download_video()	下载视频到文件或返回bytes
get_audio_stream_url()	获取音频流地址
download_audio()	下载音频到文件或返回bytes
post_devices_camera_uploads()	上传摄像头内容
restore_backup()	恢复备份

常用函数示例

查询媒体库

# 查询所有电影
movies = get_items(include_item_types="Movie", recursive=True, limit=20)

# 搜索媒体
results = get_items(search_term="avatar", recursive=True)

# 按类型查询
series = get_items(include_item_types="Series", recursive=True)

用户管理

# 获取所有用户
users = query_users()

# 获取指定用户
user = get_user_by_id("user-id-here")

# 标记影片为已播放
mark_item_played(user_id="user-id", item_id="item-id")

图片操作

# 获取图片Response对象
resp = get_item_image(item_id="xxx", image_type="Primary", index=0)

# 下载图片到文件
download_item_image(item_id="xxx", image_type="Primary", output_path="poster.jpg")

# 直接获取图片bytes
bytes_data = download_item_image(item_id="xxx", image_type="Primary")

视频/音频下载

# 下载视频
download_video(item_id="xxx", output_path="movie.mp4")

# 下载音频
download_audio(item_id="xxx", output_path="song.mp3")

Live TV

# 获取频道
channels = get_live_tv_channels()

# 获取节目指南
programs = get_live_tv_programs(channel_id="xxx", start_time="2024-01-01", end_time="2024-01-07")

# 获取录制
recordings = get_live_tv_recordings()

完整API列表

详见 emby.py 文件，包含以下分类:

• Artists - 艺术家相关
• Albums - 专辑相关
• Codecs - 编解码器
• Channels/Collections - 频道/收藏
• Devices - 设备管理
• Genres - 类型
• Items - 媒体项
• Users - 用户管理
• UserData - 用户数据
• Sessions - 会话
• Playlists - 播放列表
• Plugins - 插件
• Library - 媒体库
• LiveTV - 直播电视
• LiveStreams - 直播流
• Localization - 本地化
• Movies - 电影
• AudioBooks - 有声书
• Auth - 认证
• Backup - 备份
• Branding - 品牌
• Connect - Emby Connect
• DisplayPreferences - 显示偏好
• DLNA - DLNA
• Encoding - 编码设置
• Environment - 环境
• Images - 图片
• Packages - 包
• Persons - 人物
• Studios - 工作室
• Tags - 标签
• Trailers - 预告片
• Years - 年份
• Features - 特性
• UI - 用户界面
• Videos - 视频操作
• Web - Web配置
• OpenAPI - OpenAPI文档
• Playback - 播放
• Hubs - 中心
• Search - 搜索