这个项目能做什么

KalinkaAI 是 Kalinka 音乐系统的客户端应用,该音乐系统是面向树莓派和 Linux 硬件的自托管 Hi-Fi 方案。本仓库仅包含遥控端:它自身不播放任何内容,需要同一网络中单独的 Kalinka Music Server。该服务器托管在 KalinkaPlayer 仓库中,提供 C++/ALSA 音频引擎、带元数据增强的曲库索引器,以及基于 CLAP 的语义搜索引擎。 该应用可在 Android、Windows、Linux 桌面和浏览器中运行。它通过 mDNS 发现服务器,也接受手动输入的地址。设置向导会引导首次连接。服务器还在 8000 端口提供浏览器播放器,因此严格来说无需安装客户端。 一项核心能力是语义搜索:诸如“something melancholic for tonight”这样的自然语言短语会被转换为匹配的曲目,并在用户自己的硬件上处理。该项目声明不依赖云端,也没有订阅或账号。 各平台的安装方式均有文档说明。Android 用户可通过 Obtainium 安装,它会直接从 GitHub Releases 拉取并保持应用更新,也可手动下载通用 APK。发布版 APK 使用已公布的证书 SHA-256 指纹签名,Obtainium 可固定该指纹。Windows x64 提供安装程序,但未进行代码签名,因此预计会出现 SmartScreen 警告。Linux x64 以 tarball 形式分发,附带安装脚本,可添加启动器图标并支持卸载。浏览器方式无需安装。 文档涵盖服务器安装、首次运行设置,以及一份带插图的应用程序手册,介绍向导、服务器状态与设置、音乐文件夹、AI 搜索和队列。源代码采用 Apache-2.0 许可,而图标、徽标和美术素材属于单独的资产许可,需要作者许可;捆绑的 IBM Plex 字体使用 SIL Open Font License 1.1。