How to Run cmus Linux Music Player on Android via Termux

Key Takeaways

- 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.
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.

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.

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.
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.

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.
More ways to use familiar tools in unexpected contexts
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
Manaal Khan
Tech & Innovation Writer
Related Articles
Browse all
How to Jailbreak Your Kindle: Escape Amazon's Control Before They Brick Your E-Reader
Amazon is cutting off support for older Kindles starting May 2026, but you don't have to buy a new device. Jailbreaking your Kindle lets you install custom software like KOReader, read ePub files natively, and keep your e-reader alive for years to come.

X-Sense Smoke and CO Detectors at Home Depot: UL-Certified Alarms You Can Actually Trust
X-Sense just made their UL-certified smoke and carbon monoxide detectors available at Home Depot stores nationwide. The lineup includes wireless interconnected models that can link up to 24 units, 10-year sealed batteries, and smart features designed to cut down on those annoying false alarms that make people disable their detectors entirely.

How to Change Your Browser's DNS Settings for Faster, Private Browsing in 2026
Your browser's default DNS settings are probably slowing you down and leaking your browsing history to your ISP. Here's why changing this one setting should be the first thing you do on any new device, and how to pick the right DNS provider for your needs.

Raspberry Pi at 15: Why the King of Single-Board Computers Is Losing Its Crown
After 15 years of dominating the hobbyist computing scene, the Raspberry Pi faces serious competition from cheaper alternatives, supply chain headaches, and a market that's evolved past its original mission. Here's what's happening and what it means for your next project.
Also Read

Disney+ June 2026: Avatar, Hamilton Docs, Adventure Time
Disney+ rolls out its June 2026 lineup with the streaming debut of Avatar: Fire and Ash on June 24, a Hamilton 10th anniversary documentary, and a new Adventure Time spin-off. The month also brings a Korean medical drama from Hulu and new episodes from Disney Channel favorites.

5 Chrome Tricks That Work Without an Internet Connection
Google Chrome has offline capabilities most users never discover. From turning a tab into a notepad to playing local media files, these features work without extensions, accounts, or even Wi-Fi.

5 DeWALT Tools That Cut Hours Off Common Trade Jobs
Beyond the standard drill and driver, DeWALT's catalog includes specialty tools that automate tedious tasks for electricians, plumbers, and general contractors. From a cordless staple nailer that drives 1,800 staples per charge to a copper swage tool that works 3x faster than manual methods, these lesser-known options target specific pain points that eat up job site time.