音声买得多了,文件夹就会越来越长。有时只记得封面和声优,却想不起作品名字;有时昨晚听到一半,第二天又要拖着进度条找位置。文件都在自己的硬盘里,找到它、接着听,却还要费一点功夫。
Kikoto 是我做的一个开源音声库,想把这些事情放到一起:用封面浏览作品,按声优和标签找音声,记下想听的列表,再从上次停下的地方继续。把它部署在电脑或 NAS 上,浏览器和 Android、iOS 客户端都能访问同一个库。下文按 Kikoto v0.10.0 介绍。

如果想先看看界面,可以打开在线演示 。演示站只读,展示的是 DLsite 的免费全年龄作品;Kikoto 本身不提供音声资源,用来管理自己购买的作品。
把文件夹变成能搜索的媒体库
Kikoto 会扫描你指定的音声目录,从文件夹名称里的 RJ 等作品编号识别作品,再同步 DLsite 的标题、封面、社团、声优和标签。原来的目录可以继续使用,不必先把所有文件手工录入一遍。
可以把入库过程理解成两条线:一条找到硬盘上的文件,另一条补齐作品信息,最后在同一个媒体库里浏览和播放。
flowchart TB
A["自己的音声文件夹"] -->|扫描文件| C["Kikoto 媒体库"]
B["DLsite 作品信息"] -->|同步封面与介绍| C
C --> D["搜索与收藏"]
C --> E["播放与接着听"]想听某位声优的作品,可以直接搜名字;只记得社团、标题的一部分或作品编号,也能找到。想更精确一点,可以用 tag: 癒し、circle:、va: 分别限定标签、社团和声优,在前面加 - 则排除匹配的作品。标签已经有对应的多语言名称时,用其他语言的名称也能匹配。
平时可以按推荐、最近添加、评分、销量或发行日期浏览;不想挑的时候,也可以随机看看。点进社团或声优页面,就能顺着自己喜欢的创作者继续找作品。

详情页把封面、制作信息和文件目录放在一起。音轨可以直接播放,同目录里的图片、文本和字幕也能预览,查看附带内容时不用再切回文件管理器。
多语言作品有两个独立选择:元数据语言在有对应内容时改变标题、简介和标签的显示,目录版本切换实际文件。比如用中文标题浏览日文音轨,或者打开已经保存的英文版目录。切换文字的显示语言,不会改变音频本身。
听到哪里,下次就从哪里继续
点一条音轨开始播放,同文件夹的其他音轨会进入队列。浏览别的作品时,播放仍然继续;播放器可以收起,需要看歌词或调整队列时再展开。
Kikoto 会保存收听进度。下次打开作品,点「继续播放」就能回到上次停下的位置,不必先猜是哪一条音轨。想从头听某一条时,直接点那条音轨即可。

作品附带 LRC、VTT、SRT 等字幕文件时,可以像歌词一样跟着音频看。带时间轴的句子还能点击跳转,听漏了一句,点回去就好;有多个匹配的歌词文件时,也可以自己选择。
没有歌词的音轨,可以在作品的「管理歌词」里用语音识别转写成带时间轴的歌词,预览确认后再加入。已有的歌词,以及标题、简介、标签和文件名,也能用「AI 翻译」补上其他语言。歌词按语言分别保存,播放时优先使用自己设置的元数据语言;AI 生成的歌词,播放器也会标出来。
转写和翻译需要管理员先在「设置 → 语音识别与大语言模型」里接入服务,可以用 OpenAI 兼容接口、Ollama 等,也可以用 Kikoto Helper 在 Windows 电脑上本地运行模型。使用外部服务时,记得先看看对方的使用条款。
播放器还支持调速、队列排序、后退 10 秒和前进 30 秒。睡前听可以设置睡眠定时器,并让它停止后往回倒一点,第二天更容易找到还记得的段落。
电脑浏览器可以把歌词放进画中画小窗;Android 客户端获得悬浮窗权限后,可以在其他应用上方显示歌词;iOS 客户端则用画中画窗口显示。看歌词不一定要一直停留在播放器页面。
把想听和听过的作品整理起来
文件夹通常只能告诉你「有哪些作品」,收藏架还可以告诉你「准备听什么、正在听什么、已经听过什么」。作品卡片和详情页上都有快速标记,可以标为想听、正在听、已完成、重听或已搁置;旁边还能给作品打一到五星的个人评分。作品也能放进自己建立的收藏列表,例如睡前听、喜欢的耳かき、想重听的剧情;动态列表则按标签自动收录作品。
个人标签可以加在作品、社团和声优上。评分、收藏和标记会参与推荐:打了四五星的作品会让相似的作品更靠前,一两星则让它们靠后。账号之间分别保存个人的收藏与收听数据,同一个库也可以有不同的整理方式。
不知道听什么,就去「发现」看看
「发现」页面用来找下一部想听的作品。「为你推荐」每次从本地作品里抽几部:可能喜欢的、平时很少听的,以及喜欢过却很久没听的,每张卡片都写着抽中的理由。在社团、系列或声优页面点铃铛订阅后,他们的新作会出现在「新作」里;「排行榜」跟踪 DLsite 排行榜的名次变化。
想回顾自己听了什么,可以打开「数据面板」。这里有一年的收听日历、年度报告,以及和整个媒体库对比得出的口味画像,能看到最常听的作品、声优、社团和标签。
文件分散在不同地方也能管理
作品放在多块硬盘上时,可以使用存储池,把每块盘作为独立的媒体位置加入。某块盘暂时没接上,会显示离线,扫描时仍然保留这块盘上的已有作品记录。
同一部作品在几个文件夹里各有一份时,可以打开作品的「管理文件」,从其他文件夹或远程版本把需要的文件集中到一个文件夹;「查找重复文件」会按内容标出完全相同的副本,确认后再删除。
如果已经有自己有权访问的 Kikoeru 兼容服务,也可以把它添加为远程来源,浏览、播放或按需取回文件。同一作品的本地、缓存与远程位置围绕同一条作品记录管理,收藏和收听记录不用跟着文件位置重复建立。
远程播放、缓存和 Fetch 各有用途:播放是直接收听,缓存是保留可重建的媒体副本,Fetch 则把选定文件保存到自己的媒体目录。只想整理本地作品的话,从一个音声文件夹开始就够了。
扫描、同步作品信息、文件获取以及转写和翻译等任务都以工作流的形式运行,进度和结果在「活动」里查看。需要定期扫描或同步作品信息时,再在「工作流」里设置自动运行规则;关注社团或声优的新作品,则用前面提到的订阅。
用 Docker 搭建自己的音声库
推荐直接用 Docker Compose 部署。需要准备一台能运行 Docker 的电脑或 NAS,以及已经保存的音声文件。镜像支持 linux/amd64 和 linux/arm64,ARM 架构的 NAS 和 64 位 Raspberry Pi OS 也能运行。部署完成后,文件和账号数据都放在自己的设备上,浏览器或客户端负责访问。
flowchart TB
A["电脑浏览器"] --> C["电脑或 NAS 上的 Kikoto"]
B["手机浏览器或 Android / iOS 客户端"] --> C
C --- D["音声文件夹"]
C --- E["账号、收藏与收听记录"]Windows 上还有一个 Kikoto Helper
,也能帮忙部署和管理 Kikoto,它现在在独立的仓库里开发和发布。不过它不是推荐的部署方式,只适合实在没办法让 Docker 正常运行的情况;能用 Docker 的话,照下面的步骤部署就好。Helper 的另一个用途是在本地运行语音识别和翻译模型,用 Docker 部署的 Kikoto 同样可以接入。原来 Kikoto 仓库里的 kikoto-helper.cmd 脚本已经不再维护。
准备 Docker 和部署目录
Windows 可以安装 Docker Desktop ;macOS 可以使用 OrbStack 或 Docker Desktop;Linux 按发行版安装 Docker Engine 和 Compose 插件。NAS 则使用系统提供的容器管理工具。
安装后,先确认终端能够执行:
| |
再建一个专门的部署文件夹,例如 Windows 下的 D:\kikoto。下载项目提供的 docker-compose.yml
,放进这个文件夹,并准备以下目录:
| |
config 保存账号、数据库和收听记录,cache 保存缓存,data 默认用来放音声。macOS 或 Linux 也可以在部署目录中用下面的命令下载配置:
| |
告诉 Kikoto 音声放在哪里
打开 docker-compose.yml,找到 volumes。默认配置如下,这只是完整文件中的一个片段:
| |
每行冒号左边是电脑上的文件夹,右边是容器里看到的路径。如果音声已经存在其他目录,修改左边的路径即可,不必再复制一份。
例如 Windows 的音声放在 D:\Audio,改成:
| |
macOS 或 Linux 同样替换左边的目录,例如 /mnt/audio:/data。Windows 路径使用 / 并加上引号,保存时保留原文件的缩进。
如果准备使用存储池,则保留 ./data:/data,再把各块盘映射成 /data/disk1、/data/disk2 等子目录,首次设置时选择对应的池。具体配置可以参考使用指南
。
启动并完成首次设置
在部署目录打开终端,先检查配置,再启动:
| |
镜像下载并启动后,在这台电脑上打开 http://127.0.0.1:7655。首次访问会要求创建管理员,初始化令牌可以在日志中找到:
| |
也可以读取 config/setup-token 文件。填入令牌,设置用户名和密码,然后跟着「设置媒体库」向导完成:
- 选择普通模式或存储池模式。
- 扫描音声目录,找到本地作品。
- 同步作品信息,补齐封面和介绍。
- 按需要开启自动扫描与文件夹监视。
作品目录名称需要包含受支持的作品编号。如果扫描后什么都没有,先检查目录映射和文件夹名称;封面暂时没出现,则可以到「活动」里看元数据同步的进度。
从手机访问
手机与部署设备连到同一个局域网后,用电脑的局域网地址访问,例如 http://192.168.1.23:7655。这里的地址要换成自己的;127.0.0.1 在手机上指的是手机本身。
Windows 可以用 ipconfig 查看实际 Wi-Fi 或以太网接口的 IPv4 地址。连接不上时,再检查电脑防火墙和路由器的访客网络隔离。部署设备需要保持运行。
Android 和 iOS 客户端都在 GitHub Releases 里:Android 下载 APK 安装;iOS 提供的是未签名的 IPA,需要用侧载工具以自己的 Apple 账户签名后安装。打开客户端,填写同一个服务器地址即可。
默认的端口映射会监听设备上的所有网络接口,不要把 Kikoto 直接暴露到公网。只在本机使用时,可以把 ports 改成 127.0.0.1:7655:7659。需要在外面收听时,先做好访问保护:例如只让自己的设备通过加密的私有网络(异地组网)连回家里,或者在前面放一个带 HTTPS 和身份验证的反向代理。具体可以参考安全说明
。
备份与日常维护
最值得保存的是音声原文件,以及 config 里的数据库和个人数据。缓存通常可以重建。Kikoto 也支持导出、导入个人的标记、评分、标签、收藏列表和收听进度,还能从 Kikoeru 导入,换设备或换实例时可以继续使用。
更新前先看一下发布说明
,里面会写明需要留意的变化;再备份 config,以及 docker-compose.yml、.env 等部署配置。音声目录保持原来的映射,不用复制。然后在部署目录执行:
| |
这条命令会拉取最新镜像并重建容器,数据库会在启动时自动升级。如果在 .env 里用 KIKOTO_IMAGE 固定了版本,先改成新的版本再执行。
更多操作可以查阅文档 。
遇到问题或有想法,也欢迎到仓库提 Issue。