kew

ravacholGPL-2.0活跃维护

一款在终端里运行的极速音乐播放器,用 C 语言编写,支持本地曲库播放,让你不离开命令行就能私密听歌。

Music for the Shell. kew is a fast, immersive music player that allows you to listen to music privately.

v4.4.3发布于 2026-11-09 17:09 UTC3,206star +9 / 7 天112fork同步于 2026-11-10 17:43 UTC

怎么上手

由 README 提炼,执行前请确认
README 未给出安装命令,安装方式请见 https://kewplayer.com
硬件要求按 README 说明

README 未说明硬件要求;支持 Linux、FreeBSD、Android、macOS、Windows 等平台

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

终端里的沉浸式音乐播放器,离线私密听歌,几乎零配置即可上手

一款在终端里运行的极速音乐播放器,用 C 语言编写,支持本地曲库播放,让你不离开命令行就能私密听歌。

核心能力

  • 按艺术家、专辑或歌名关键词自动生成播放列表
  • 支持无缝播放与自动/手动交叉淡入淡出
  • 在支持 sixel 的终端显示全彩专辑封面
  • 根据专辑配色自动生成主题并支持自定义布局
  • 内置音乐库浏览、搜索、歌词与 .m3u 导入导出

容易踩的坑

README 未列出安装步骤,需前往官网查看;HE-AAC 与 E-AC-3 格式不受支持;Discord 状态显示为可选功能,默认关闭

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v4.4.3
  1. v4.4.3最新正式版2026-11-09 · 2026-11-09 17:09 UTC

    kew 4.4.3

    This release fixes kew sometimes hanging at the end of a song, the scrollbar not scrolling all the way to the top and a few other things.

    Special thanks to @Erwin-Iosef for making many PRs!

    /Ravachol

    Enhancements
    • Added error message if kew fails to play song because it's missing or corrupt. By @Erwin-Iosef.

    • Erase whole words from search query with Ctrl+Backspace. By @Erwin-Iosef. Suggested by @yeka1063.

    • Add build option DEBUG=3 mode which has fsanitize=thread enabled. By @ravachol.

    Bug fixes
    • Fix kew sometimes hanging at the end of a song. By @ravachol.

    • Fix scrollbar not scrolling all the way. By @ravachol.

    • Bumped miniaudio to v0.11.26. By @ravachol.

    • Fix error message in some cases disappearing before the 3 second timeout. By @Erwin-Iosef.

    • Revert change that made some options stop working. By @Erwin-Iosef. Reported by @washingmachine55.

    • Fix use after return in visualization build cmd functions. By @ravachol.

    • Fix data race related to seek_elapsed. By @ravachol.

    • Fix data race related to visualizations running variable. By @ravachol.

    • Fix data race related to visualizations mode variable. By @ravachol.

    • Fix passthrough for forced coverStyle inside tmux. By @rdocksey.

  2. v4.4.22026-10-28 · 2026-10-28 10:25 UTC
    查看更新说明

    kew 4.4.2

    Notice To Package Maintainers:

    Some very large animated gif histories and the website were removed from git history using git-filter-repo. There's a script attached to the v4.4.1 release that verifies that nothing else was touched. See here: https://codeberg.org/ravachol/kew/releases/tag/v4.4.1

    Enhancements:
    • Winamp-style (projectm/milkdrop) visualizations on linux through a new plugin, pmstream. By @ravachol. How to install: https://codeberg.org/ravachol/pmstream

    • Fuzzy search. By @superb-striker.

    • Track if visualizations are enabled. By @ravachol.

    • Improved search result hierarchy and folder navigation. By @superb-striker.

    • Remembers your library sort order. By @ravachol. Suggested by @kase.

    • New settings visualizationsFps, visualizationsShowPresetInfo. By @ravachol.

    Bug fixes:
    • Fixed many minor issues in the UI layer. By @ravachol.

    • Bumped miniaudio to v0.11.25. By @ravachol. Suggested by @Surneval.

    • In playlist the 100th song was off by a column. By @ehatch.

    • Fix scrolling glitch in playlist view. By @arrbrants.

    • Re-enable name scrolling in playlist view. By @ravachol and @arrbrants.

  3. v4.4.12026-10-13 · 2026-10-13 12:21 UTC
    查看更新说明

    kew 4.4.1

    • Fixes termux package not running. By @ravachol.

    TO PACKAGE MAINTAINERS:

    After releasing v4.4.1 I rewrote the git history with git filter-repo --invert-paths to remove large binary files that had been deleted long ago plus two animated gifs in the readme which I also deleted. These files made a fresh clone ~265 MB. It is now ~16 MB. The kew binary is ~1MB so having git download 265x seemed unreasonable to me. The issue for this cleanup is also the most upvoted one we've ever had.

    All commit hashes from the first affected commit onward changed, including release tags. I’m sorry if I surprised anyone.

    What was removed: only the paths listed in removed-paths.txt, mostly images (gifs and screenshots) and the website/ and pages/ directories.

    No source files were touched. Commit authors, dates and messages are unchanged.

    How to verify: with a clone of the old history, run verify-tags.sh (attached) in a clone of the new one. For every release tag it checks that the new tree is identical to the old one except for the files on the list, and that nothing was added or modified. Output from my run is in verify-output.txt, including old → new commit hashes for every tag.

    stable-musl is a floating tag that has always moved, and it isn’t part of the comparison.

    The old history is attached to the v4.4.1 release as a bundle. You can also still get the old history by running: git fetch origin 1cec5794b16a0f5b6957b3a466dc4918c20312c9, but this might be garbage collected at some point.

    In short, to verify, run these commands:

    chmod +x verify-tags.sh ./verify-tags.sh /path/to/your/old/kew removed-paths.txt stable-musl

    It should say ok on each line and then problems: 0.

  4. v4.4.02026-10-11 · 2026-10-11 18:04 UTC
    查看更新说明

    kew 4.4.0 "PUNK TACTICS" EDITION

    This version fixes 22 bugs and leaves the repo without any open bugs!

    We also now finally have fragmented mp4 support, which means we can add mp4 as a supported type, thanks to the great work of @superb-striker.

    It has been a bit of a bumpy ride since we rewrote the UI more properly from scratch. Now it seems we are out of the woods and kew is stable again.

    We have a thing called "Project Joy" running. We want people to submit issues for every little detail, so that we can fix it and kew will be a "joy to use".

    Special thanks to @superb-striker, @arrbrants (@Cai-kunkun), @nhuvaynhe, @jsteitz and @LeahTheSlug who helped out a lot.

    Thank you to new sponsor @Demorome.

    Punk Tactics video: https://www.youtube.com/watch?v=OklSZmIx9-o (not affiliated with us)

    /Ravachol

    Enhancements:
    • MP4 support, including fragmented mp4's. By @superb-striker.

    • Spanish translation. By @victorhck.

    • Russian translation. By @adem4ik.

    • Add xesam:url to MPRIS metadata. Suggested by @keratomalaciant.

    • Add trackslist support to MPRIS. By @superb-striker.

    • Flatpak package. By @superb-striker. Suggested by @mendhak.

    • Add ability to seek while playback is paused. By @superb-striker. Suggested by @eilvelia.

    • Don't re-create device on song switching when the format is the same. By @Cai-kunkun.

    • Prettier landscape mode when there's no cover (cover area disappears). By @ravachol after issue by @lianchu114514.

    Bug Fixes:
    • Fix when clicking in the playlist view, the selection bar can go to the bottom of the playlist. By @nhuvaynhe. Reported by @jsteitz.

    • Fix scrollbar unresponsive on very large terminal sizes. By @ravachol. Found by @LeahTheSlug.

    • Fix library view position jumping, when expanding a folder, then scrolling down with the scrollbar, then expanding another one. By @ravachol.

    • Fixes several smaller issues with MPRIS implementation. By @ravachol.

    • Fixes issue with unicode string length of folders in library. By @ravachol.

    • Fixes stale .m3u playlist causing a crash. By @ravachol. Reported by @Needlide.

    • Fix raw AAC ADTS support. By @superb-striker.

    • Fix Help view doesn't clear bottom lines cleanly when scrolling, showing duplicate lines. By @ravachol.

    • Prevent open_url from firing twice. By @ravachol.

    • Fix resources not being freed correctly in get_dbus_connection_with_timeout(). By @ravachol.

    • Fix stalling of audio on 192khz songs on Pipewire. By @ravachol. Found by @Cai-kunkun.

    • Allow seeking back on small sound files. By @superb-strike.

    • Fix crash because of NULL in scroll_next() by @ravachol.

    • Fix landscape mode info message is very brief. Found by @LeahTheSlug. By @ArrBrants.

    • Fix use-after-free error when song was loading during the cleanup of decoders. By @ravachol.

    • Fix sometimes the selected song in the library moves up until it disappears. By @ravachol.

    • Fix kb/s on songs of different kHz not displayed back to back. By @ravachol. Found by @LeahTheSlug.

    • Fix windows build issue. By @AcidRain.

    • Fix off-by-one in length check. By @dirkmueller.

    • Fix issue where collapse library to top level led to enqueueing requireing several key presses sometimes. By @ravachol.

    • Fix hide mini-controls below the side cover if mouseEnabled=0. By @ravachol.

    • Fix check for artists db returning a false positive. By @ravachol.

  5. v4.3.82026-09-26 · 2026-09-26 16:21 UTC
    查看更新说明

    kew 4.3.8

    • Fix windows installer error. By @ravachol.

    kew 4.3.7

    Enhancements:
    Bug Fixes:
    • Respect mouseEnabled=0 and hideTimeStatus=1 again. These settings were lost during the UI rewrite. By @ravachol. Reported by @jsteitz.

    • Fix keybindings with Ctrl+a..z being ignored. By @ravachol. Reported by @jsteitz.

    • Windows: Fix crash when running kew not as a shortcut but from within a terminal. This was caused by adding SMTC windows media key integration and ISystemMediaTransportControlsInterop::GetForWindow checking window ownership internally and throwing E_ACCESSDENIED because the HWND is owned by the terminal. By @ravachol. Reported by @battlelitany.

    • Fix Chroma printed in the wrong position for songs with non-square album covers. By @nhuvaynhe.

    • Fix crash sometimes when there was no song cover. By @ravachol. Found by @SoupKitten.

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    License

    kew (/kjuː/, variant of cue) is a terminal music player.

    kew - Music for the Shell

    Please visit the website for information on how to install, use and contribute to kew.

    https://kewplayer.com

    Features

    • Play auto-generated playlists based on words from the artist, album or song name: 'kew nirvana'.
    • Gapless playback.
    • Requires virtually no setup.
    • Private and offline*.
    • Music without distractions or algorithmic manipulation.
    • Full color covers in sixel-capable terminals.
    • Spectrum visualizer.
    • Auto-generated themes based on album colors and custom themes.
    • Music library explorer.
    • Playlist editing (add, reorder, delete).
    • Search.
    • Lyrics support.
    • Desktop integration (both Linux and macOS).
    • Import/export .m3u playlists.
    • Replay gain.
    • Custom layouts.
    • Crossfade (experimental), both automatic and on demand.
    • Auto-Resume.
    • Available on Linux, FreeBSD, Android, macOS, Windows and others.

    * kew can display your listening status in Discord, but this is now opt-in by popular demand.

    Supported formats

    Supported: mp3,flac, opus, ogg, m4a (including alac), mp4, raw aac, wav, webm.

    With caveats, not supported:
    • HE-AAC.
    • E-AC-3.

    License

    Licensed under GPLv2+. See LICENSE for more information.

    Star History

    Github Stars: GitHub stars

    Codeberg Stars: Codeberg stars