Sunamu: Display Lyrics for Currently Playing Music on the Desktop in Linux

Being an eye candy music widget (or controller).

That’s the only focus of Sunamu, and it does its job pretty well.

Sunamu is an intriguing tool. It is not a music player but lets you display the music you’re playing and control it.

I’m not a fan of having a floating widget on my primary workspace, but Sunamu’s minimal yet elegant approach changed my mind!

So, I will walk you through its features, installation, configuration tweaks, and my experience with it.

Sunamu: An Open-Source Music Controller

playing music with sunamu

As you can notice in the screenshot above, it looks like a pretty nice way to display the music being played, with the lyrics, while having the basic controls.

You can play/pause, go to the next/previous track, shuffle, and enable a loop.

Sunamu supports a wide range of audio platforms, including Spotify. It also detects music from your local collection, supporting some of the best music players available for Linux.

Additionally, it supports Windows. So, if you are streaming something through the Microsoft Edge browser on Windows, it should work well.

You can check the compatibility list on its GitHub page to learn more about the supported players and browsers.

Fortunately, you do not have to be limited by what it offers by default. It provides an easy way to tweak the config file (learn more about it on its GitHub page). This makes it possible for newbies to tweak some settings and have fun.

I’ll mention a few tips about it in the later section of this article.

Features of Sunamu

Sunamu on empty workspace

Sunamu comes with a set of promising features, and some of them are:

  • Detects and display the song that is currently playing.
  • Fetch color schemes from the album art and use the same color palette for better visuals.
  • Customizable through its config file.
  • Integrates well with Discord.
  • Consumes minimal system resources.

Install Sunamu on Linux

Disable lyrics in sunamu

It provides AppImage, deb, and rpm packages for easy installation across various Linux distributions. I used AppImage for testing, and it worked like a charm.

You can also benefit from our guide on how to use AppImage or install deb packages and rpm packages, if you are new to Linux.

Interestingly, Sunamu is one of the few open-source music tools that provide direct support for ARM-based machines.

Visit their GitHub releases page to download packages or build it from the source.

Let me show you a quick installation method for a Debian-based distro via the terminal. Just follow the given instructions, and you’ll be good to go:

First, let’s download the .deb package using wget command as follows:


Once you are done downloading the package, use the given command for installation:

sudo dpkg -i sunamu_2.0.0_amd64.deb
install sunamu in ubuntu

Tip: Tweak the Configuration file

By default, Sunamu won’t fetch colors from the album art but show the lyrics for each song. And like many others, I like to avoid reading lyrics.

Config file of Sunamu is usually located at ~/.config/sunamu/config.json5.

To open the Sunamu config file, type the given command:

nano ~/.config/sunamu/config.json5

Make changes in the electron section as given below (to enable colors and disable lyrics):

electron: {
      type: 'electron',
      widgetMode: true,
      colors: true,
      font: '',
      theme: 'default',
      showLyrics: false,

Here’s what the final config file should look like:

modify config file of sunamu

Final Thoughts

Unless you are someone who avoids electron-based apps, Sunamu is a good enough app to enhance your music experience on Linux. After, Amberol, this is the second Music-related app I have liked recently.

If you try it, don’t forget to share your experience in the comment section.

About the author
Sagar Sharma

Sagar Sharma

A software engineer who loves to write about his experience with Linux. While reviving my crashed system, you can find me reading literature, manga, or watering my plants.

Become a Better Linux User

With the FOSS Weekly Newsletter, you learn useful Linux tips, discover applications, explore new distros and stay updated with the latest from Linux world


Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to It's FOSS.

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.