All posts

How to Run cmus Linux Music Player on Android via Termux

Manaal KhanMay 31, 2026 at 12:33 AM5 min read
How to Run cmus Linux Music Player on Android via Termux

Key Takeaways

Article image
  • The cmus music player runs on Android through Termux with a few minutes of setup
  • Number keys 1-7 navigate between library, queue, playlists, and settings views
  • Some functions like playlist creation (key 0) and color schemes (key 8) don't work on Android

If you spend time working in terminals, you probably have favorite CLI and TUI apps. One standout is cmus, a text-based music player with minimal graphics but powerful organization features. It turns out this Linux favorite runs well on Android phones through Termux.

David J. Buck from How-To Geek documented the process of getting cmus working on his Samsung Galaxy Z Fold 5. The setup takes only a few minutes and delivers a music playback experience he considers better than most Play Store alternatives.

Advertisements

Setting Up cmus on Android

The process starts with Termux, the terminal emulator for Android. Once Termux has storage permissions, you can access your music files through the storage folder. Use cd storage to navigate there, then ls to list your directories.

To add music to cmus, you have two options. You can use the number pad to navigate to your directory, or use the :add command in the command line at the bottom of the screen. Find your file path using the pwd command in your music directory.

Keyboard Navigation and Commands

The navigation system in cmus relies heavily on number keys. Keys 1 through 7 each take you to a different display: library, queue, playlists, instructions, and customization settings. This keyboard-driven approach works well once you learn the shortcuts.

Using commands in cmus to play back some songs.
Using commands in cmus to play back some songs.

You can combine commands and shortcut keys for efficient control. The command line at the screen bottom accepts various instructions for playback control, library management, and settings changes.

What Works and What Doesn't

Not everything translates perfectly from desktop Linux to Android. The 0 key, normally used for creating playlists, throws a "not enough arguments" error on the phone. The 8 key for changing color schemes also fails to work.

The not enough arguments error after pressing 0.
The not enough arguments error after pressing 0.

For album-focused listeners, the playlist limitation matters little. Buck notes he prefers listening to entire albums, live shows, or box sets from start to finish. The library and queue features handle this workflow well.

Advertisements

Customization Options

Despite the Android limitations, cmus offers various customization settings accessible through the interface. Keybindings can be adjusted to match your preferences, though some desktop-specific features may not apply in the Termux environment.

A screenshot of the different keybindings settings in cmus.
A screenshot of the different keybindings settings in cmus.

Why Use a TUI Player Instead of a GUI App?

The appeal of cmus lies in its simplicity and efficiency. No album art loading, no social features, no subscription prompts. Just your music files, organized by artist and album, controlled by keyboard commands.

For developers and sysadmins who already spend time in terminals, keeping a consistent workflow across desktop and mobile makes sense. The skills transfer directly. Commands you know from Linux work the same way on your phone.

Also Read
5 Chrome Tricks That Work Without an Internet Connection

More ways to use familiar tools in unexpected contexts

The cmus Library view running on Termux.
The cmus Library view running on Termux.
A screenshot of various customization settings in cmus.
A screenshot of various customization settings in cmus.
A screenshot of the unbound commands that must be entered in the command line in cmus.
A screenshot of the unbound commands that must be entered in the command line in cmus.
ℹ️

Logicity's Take

Frequently Asked Questions

Does cmus work on all Android phones?

cmus should work on any Android device that can run Termux. The key requirement is giving Termux storage permissions to access your music files.

What music formats does cmus support?

cmus supports common formats including MP3, FLAC, Ogg Vorbis, WAV, and others. Format support depends on the libraries installed in your Termux environment.

Can I use cmus with Bluetooth headphones?

Yes, cmus uses Android's audio output system through Termux. Any audio output method your phone supports, including Bluetooth, should work.

Is there a way to control cmus without the keyboard?

cmus is designed for keyboard control. On Android, you can use Termux's on-screen keyboard or connect an external Bluetooth keyboard for the best experience.

ℹ️

Need Help Implementing This?

Source: How-To Geek

M

Manaal Khan

Tech & Innovation Writer

Produced with AI assistance and reviewed by the Logicity editorial team. Learn more in our Editorial Policy.