<h3 align="center">
<img src="https://raw.githubusercontent.com/qxb3/fum/refs/heads/main/repo/logo.png" width="200"/>
</h3>
<h2 align="center">
fum: A fully ricable tui-based mpris music client.
</h2>
<p align="center">
fum is a tui-based mpris music client designed to provide a simple and efficient way to display and control your music within a tui interface.
</p>
# ❗❗ IMPORTANT ❗❗
> ⚠️ **Currently in a full codebase rewrite**
> See [#98](https://github.com/qxb3/fum/issues/98) for the motivations on why.
<p align="center">
<a href="https://discord.gg/UfXMeyZ6Zt">
<img src="https://img.shields.io/discord/1331325131649454184?style=for-the-badge&logo=discord&logoColor=%23ffffff&label=discord&labelColor=1C1B22&color=DEFEDF" />
</a>
<a href="https://github.com/qxb3/fum/blob/main/LICENSE">
<img src="https://img.shields.io/badge/MIT-DEFEDF?style=for-the-badge&logo=Pinboard&label=License&labelColor=1C1B22" />
</a>
<a href="https://github.com/qxb3/fum/stargazers">
<img src="https://img.shields.io/github/stars/qxb3/fum?style=for-the-badge&logo=Apache%20Spark&logoColor=ffffff&labelColor=1C1B22&color=DEFEDF" />
</a>
</p>
## Demo
<img
width="800px"
src="https://github.com/user-attachments/assets/930283d8-6299-4ef9-865b-26960dcee866"
/>
## Installation
[](https://repology.org/project/fum/versions)
## Build from source
```bash
git clone https://github.com/qxb3/fum.git
cd fum
cargo build --release
# Either copy/move `target/release/yum` to /usr/bin
# Or add the release path to your system's path
# Moving fum binary to /usr/bin
mv target/release/fum /usr/bin
```
### Configuring
See [Wiki](https://github.com/qxb3/fum/wiki/Configuring)
### Need help?
Join [Discord Server!](https://discord.gg/UfXMeyZ6Zt).
## Showcase on a rice
<img src="https://github.com/qxb3/fum/blob/main/repo/showcase.png" />
## Contributing
[CONTRIBUTING](https://github.com/qxb3/fum/blob/main/CONTRIBUTING.md)
## LICENSE
[MIT](https://github.com/qxb3/fum/blob/main/LICENSE)