<div align="center">
  <img src="website/images/logo.png" alt="kew Logo">
</div>

<br>

<div align="center">
  <a href="https://jenova7.bandcamp.com/album/lost-sci-fi-movie-themes">
    <img src="images/kew-terminal-music-player.gif" alt="kew terminal music player screenshot">
  </a>
  <br>
</div>
<br><br>

[![License](https://img.shields.io/github/license/ravachol/kew?color=333333&style=for-the-badge)](./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

<a href="https://repology.org/project/kew/versions"><img src="https://repology.org/badge/vertical-allrepos/kew.svg" alt="Packaging status" align="right"></a>

 - 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: m4a, raw aac, mp3, flac, wav, webm, opus, ogg.

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


## License

Licensed under GPLv2+. [See LICENSE for more information](./LICENSE).

## Star History

<a href="https://www.star-history.com/?repos=ravachol%2Fkew&type=date&legend=top-left">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=ravachol/kew&type=date&theme=dark&legend=top-left&sealed_token=Rvnqq737BSgxceV0hxpyv8Cf4y8XHCmaT-FnAGqZFBp9F5FwUMqEmaO1fatcegP9hMpANpgxCWPTxwhZY4FxjOw0WyCGokGa19av0xHw5SVMYMd6d5KpS__VJYLH7eeUuPm4sUxLExWJeBctnZJoQw7A7ZhnxbosqzedwpiJTKGG23Cy9urTHrr1Gk_V" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=ravachol/kew&type=date&legend=top-left&sealed_token=Rvnqq737BSgxceV0hxpyv8Cf4y8XHCmaT-FnAGqZFBp9F5FwUMqEmaO1fatcegP9hMpANpgxCWPTxwhZY4FxjOw0WyCGokGa19av0xHw5SVMYMd6d5KpS__VJYLH7eeUuPm4sUxLExWJeBctnZJoQw7A7ZhnxbosqzedwpiJTKGG23Cy9urTHrr1Gk_V" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=ravachol/kew&type=date&legend=top-left&sealed_token=Rvnqq737BSgxceV0hxpyv8Cf4y8XHCmaT-FnAGqZFBp9F5FwUMqEmaO1fatcegP9hMpANpgxCWPTxwhZY4FxjOw0WyCGokGa19av0xHw5SVMYMd6d5KpS__VJYLH7eeUuPm4sUxLExWJeBctnZJoQw7A7ZhnxbosqzedwpiJTKGG23Cy9urTHrr1Gk_V" />
 </picture>
</a>

Github Stars: [![GitHub stars](https://img.shields.io/github/stars/ravachol/kew?style=social)](https://github.com/ravachol/kew/stargazers)

Codeberg Stars: [![Codeberg stars](https://img.shields.io/gitea/stars/ravachol/kew?gitea_url=https://codeberg.org)](https://codeberg.org/ravachol/kew/stars)

