songrec.fossplant.re

SongRec 的图形界面（GUI）会保存已识别歌曲的历史记录，并支持将这份记录导出为 CSV 文件，便于整理或备份。前提是你通过 GUI 完成过歌曲识别——命令行方式只用于文件识别，历史记录功能属于 GUI。以下说明基于 SongRec 官方页面列出的功能，具体按钮位置以你安装的版本为准。

查看识别历史

历史记录由 GUI 维护，记录的是你在图形界面中识别过的歌曲。使用步骤：

1. 从 Flathub、Launchpad PPA、Arch 官方仓库或 Snap Store 安装并启动 SongRec 的图形界面版本。
2. 通过麦克风或音频文件完成至少一次识别。
3. 在 GUI 中打开历史记录区域，即可看到已识别歌曲的列表。

需要注意：历史记录依赖 GUI 会话，命令行识别不会出现在这份记录里。如果你主要用命令行处理音频文件，需要另行保存识别结果。

导出为 CSV

在 GUI 的历史记录中提供导出功能，输出格式为 CSV。操作路径为：打开历史记录 → 选择导出 → 指定保存位置，得到可用表格软件打开的 CSV 文件。

导出后的典型用途：

• 用 LibreOffice Calc 或 Excel 打开，按歌手、曲名排序整理；
• 作为本地备份，避免重装系统后丢失识别结果；
• 把多次识别的结果合并成一份歌单素材。

常见卡点

适合谁用

如果你希望把零散的“听歌识曲”结果沉淀下来，SongRec 的 GUI 历史记录加 CSV 导出是最直接的方式；如果你只需要一次性识别某个音频文件，命令行更轻量，但不会有可导出的历史。两者可以配合使用：日常用 GUI 积累记录，批量文件用命令行处理。

开源软件指源代码公开、允许他人查看、修改和再分发的软件。它不等于免费，也不等于没有版权——是否收费、能否商用、二次发布要满足什么条件，取决于具体的开源许可证。对普通人来说，判断一款开源软件值不值得用，关键看三点：许可证是否匹配你的用途、项目是否仍在活跃维护、以及它能否解决你的具体任务。下面按这三个维度展开。

开源软件和"免费软件"不是一回事

很多人把开源等同于免费，这是最常见的误区。开源描述的是源代码的获取与使用权利，免费描述的是价格。两者可以重合，也可以分离：

• 有的开源软件完全免费，靠社区或捐赠维护；
• 有的开源软件本身免费，但官方提供付费的技术支持、托管或企业版；
• 也有软件免费但不开源（只给可执行文件，不给源代码）。

所以看到"开源"两个字，不要直接推断"免费"或"可以随便用"。真正决定你能怎么用的，是它附带的许可证。

常见许可证决定你能做什么

许可证是开源软件的使用规则。同样是开源，不同许可证对"修改后要不要也开源""能不能闭源商用"的要求差别很大。下面是最常见的几类：

对普通用户来说，日常使用（自己装来用、不修改不分发）几乎不受许可证限制。真正需要留意许可证的是两类人：把开源代码嵌进自己产品再发布的开发者，以及想基于开源项目做二次分发的人。如果你属于这两类，务必先读项目根目录下的 LICENSE 文件，而不是凭印象判断。

开源不等于安全，也不等于好用

"源代码公开所以更安全"是一种想当然。公开确实让更多人能审查代码，但有没有人真的去审查、发现问题后有没有人及时修，才是安全的关键。判断一个开源项目是否可靠，可以看这些信号：

• 最近提交时间：仓库几个月甚至几年没更新，遇到漏洞可能没人修；
• issue 和 PR 的响应：大量长期未处理的 issue，说明维护者精力有限或已放弃；
• 发布节奏：是否有稳定的版本发布，还是长期停在某个旧版本；
• 社区规模：文档、论坛、问答是否活跃，出问题能不能找到人。

反过来，一个更新频繁、社区活跃的小众开源工具，往往比一个多年不更新的大牌项目更值得信任。

按用途挑选开源替代品

选开源软件，先明确你要完成的任务，再看有没有成熟替代品。以图像处理为例，ImageOptim 就是一类面向"压缩图片、减小文件体积"任务的开源工具，它的定位是替代"导出为 Web 格式"这类操作，而不是替代完整的图像编辑软件。这说明一个重要思路：开源替代品常常只覆盖某个具体环节，而不是一比一替换整个商业软件。

按用途大致可以这样找：

• 图像/媒体处理：先想清楚是"编辑"还是"压缩/转换"，前者找编辑器，后者找专用工具；
• 办公文档：找能读写通用格式（如 docx、xlsx）的套件，注意复杂排版可能走样；
• 开发工具：这类开源生态最成熟，编辑器、版本控制、包管理基本都有开源方案；
• 系统工具：压缩、清理、格式转换等小工具，开源选择非常多。

挑选时的通用检查清单：

1. 它能不能完成你的核心任务（先看功能，不看名气）；
2. 最近一次更新是什么时候；
3. 有没有清晰的安装说明和文档；
4. 出问题时去哪里求助（issue 区、论坛、聊天群）。

安装和使用中的常见卡点

开源软件的安装方式比商业软件更杂，遇到问题先分清是哪一类：

• 来源不明：只从项目官网或官方代码仓库下载，不要用来路不明的第三方打包版本；
• 依赖缺失：部分工具需要先装运行环境或其他组件，报错信息通常会指出缺什么；
• 权限与系统限制：某些系统会拦截未签名应用，需要手动允许，操作前确认来源可信；
• 版本混乱：同一工具有稳定版和开发版，日常使用优先选稳定版。

遇到问题时的求助顺序

1. 先查官方文档：多数基础问题文档里就有答案；
2. 搜 issue 区：你的问题很可能别人已经提过，看有没有解决方案或临时绕过办法；
3. 看社区论坛/聊天群：适合文档没覆盖的使用经验类问题；
4. 自己提 issue：写清版本、系统、复现步骤和报错信息，越具体越容易被回应。

提 issue 时不要只写"用不了"，而要写"在什么系统、什么版本、执行了什么操作、期望什么结果、实际报了什么错"。这几乎决定了你能不能得到有效帮助。

一句话决策

日常自己用、不修改不分发，选开源软件主要看功能是否够用 + 项目是否还在维护；要把代码嵌进自己的产品再发布，才需要认真读许可证。开源是权利和协作方式，不是质量或免费的保证——把它当成一个需要核实的选项，而不是一个可以放心的标签。

SongRec 是 Linux 上的非官方开源 Shazam 客户端，用 Rust 编写。安装渠道按平台区分：Linux 用户可选 Flathub（适用于 Ubuntu、Fedora、Arch、Manjaro 等发行版）、Ubuntu 24.04+ 的 Launchpad PPA、Arch Linux 的 extra 仓库、Ubuntu 的 Snap Store；Windows x64 用户可下载安装程序或独立 EXE；也可以自行编译。选择哪条渠道，取决于你的发行版和是否愿意使用容器化打包。

Linux 安装渠道对比

如果你用的是 Ubuntu 24.04 及以上版本，PPA 和 Snap 都可以考虑；其他发行版优先选 Flathub。Arch 用户直接用 extra 仓库最省事。

Windows 安装

Windows x64 提供两种形式：安装程序（installer）和独立 EXE（standalone）。安装程序适合希望走常规安装流程的用户；独立 EXE 适合不想安装、直接运行的用户。

自行编译

如果上述渠道都不适用，或你希望从源码构建，可以按 GitHub readme 的说明自行编译 SongRec。

安装后能做什么

SongRec 支持从任意音频文件识别歌曲、从麦克风识别、GUI 与命令行两种文件识别方式、GUI 内识别历史（可导出 CSV）、麦克风连续检测并选择输入设备，以及在兼容的 PulseAudio 环境下从扬声器而非麦克风识别。安装渠道只决定你如何获得软件，功能在各平台上基本一致。

遇到 bug 或想提功能需求，优先使用 GitHub issues；GitHub issues 不方便时，也可通过项目的 Matrix 频道沟通，但该频道的信息可能被遗漏。

遇到 Bug 或想提功能请求，首选渠道是 GitHub issues；只有在 GitHub issues 不便使用时，才用 Matrix 频道 作为补充沟通方式，且该频道的消息可能被忽略，不适合作为首选。

首选：GitHub issues

SongRec 官方页面明确说明，与 SongRec 相关的任何 bug 报告或功能请求，都应通过 GitHub issues 作为沟通渠道提交。这是开发者指定的正式反馈入口，适合以下场景：

• 识别结果错误、崩溃、界面异常等 Bug 报告
• 新功能建议或改进请求
• 安装包、发行渠道相关的问题反馈

提交前建议先浏览已有 issue，确认是否已有人报告同类问题，避免重复。提交时尽量写清：使用的发行渠道（Flathub、Launchpad PPA、Arch 官方仓库、Snap Store 或 Windows 安装包）、系统环境、复现步骤和预期结果。

补充：Matrix 频道

官方页面提到，只有在 GitHub issues 使用起来不令人满意时，才考虑 SongRec 的 Matrix 频道。需要特别注意的是，官方原文提示：发送到 Matrix 频道的内容可能会被遗忘。因此它更适合临时性、非正式的交流，而不是需要被跟踪处理的问题报告。

其他可参考的信息入口

如果问题不是反馈而是想了解功能与实现方式，官方页面指向 GitHub readme，其中列出了 SongRec 的功能列表和工作原理说明。SongRec 本身是一个用 Rust 编写的非官方开源 Shazam 客户端，支持从任意音频文件或麦克风识别歌曲，提供 GUI 与命令行两种文件识别方式，GUI 中可查看识别历史并导出为 CSV，还支持麦克风连续识别与选择输入设备，在兼容的 PulseAudio 环境下可从扬声器而非麦克风识别歌曲。这些功能细节在 readme 中有更完整的说明，遇到使用疑问时可先查阅。

常见卡点

• 把 Matrix 当主渠道：官方已说明消息可能被遗忘，重要问题应走 GitHub issues。
• 反馈信息不全：未注明安装渠道和系统环境，会增加定位难度。
• 重复提交：提交前先搜索已有 issue，能减少无效沟通。

SongRec 是一个非官方的开源 Shazam 客户端，主要面向 Linux 桌面，用 Rust 编写。它的核心用途是识别歌曲：既可以识别任意音频文件，也可以从麦克风或系统扬声器持续采集声音来识别。项目官网 songrec.fossplant.re 本身不提供在线识别服务，而是下载入口和项目说明页，识别功能需要安装客户端后在本机运行。

它能做什么

根据项目说明，SongRec 提供以下能力：

• 识别音频文件：对任意音频文件做歌曲识别，图形界面和命令行都能用。
• 识别麦克风声音：从麦克风采集音频进行识别，并可选择输入设备。
• 持续检测：从麦克风连续识别歌曲，适合边放歌边自动记录。
• 识别扬声器输出：在兼容的 PulseAudio 环境下，可以直接识别电脑正在播放的声音，而不必用麦克风对着音箱。
• 历史记录：图形界面保存识别过的歌曲历史，可导出为 CSV。

命令行只覆盖文件识别部分；麦克风、扬声器识别和历史记录属于图形界面功能。

支持哪些平台

官方下载入口覆盖的范围是：

虽然项目定位是 Linux 客户端，但官网也提供了 Windows x64 的安装包和独立 EXE。具体版本号和系统要求以各下载页面的说明为准。

适合谁用

• 你在 Linux 桌面上，想要一个本地安装、图形界面可用的歌曲识别工具，并且希望识别记录能导出成表格。
• 你需要对已有的音频文件批量或逐个识别，愿意用命令行处理文件。
• 你想识别电脑正在播放的音乐，且系统使用兼容的 PulseAudio 配置。

如果你需要的是网页端直接上传识别、不安装任何软件，SongRec 不提供这种用法；官网只是下载和说明入口。

使用前需要知道的几点

• 非官方：它是第三方 Shazam 客户端，不是 Shazam 官方产品，识别能力依赖其对接的服务。
• 开源：源代码公开，功能列表和实现说明在 GitHub readme 中，问题反馈也走 GitHub issues；项目另有一个 Matrix 频道，但官方提示那里消息可能被遗漏。
• 安装渠道多：优先用发行版对应的包管理器或 Flathub/Snap，能减少依赖问题；自行编译适合需要改代码或打包的场景。

下一步

打开 songrec.fossplant.re，按你的系统选择对应下载入口；想先了解功能细节和实现方式，再点进 GitHub readme 查看。安装后先用一个本地音频文件测试识别是否正常，再尝试麦克风或扬声器模式。