If you’re a music enthusiast who prefers using the command line or want a lightweight, customizable music player on Ubuntu, installing cmus is an excellent choice. cmus (C* Music Player) is a free, open-source, terminal-based audio player that offers a rich feature set, including playlist management, support for various audio formats, and seamless integration with your system. Whether you’re looking to manage your music library efficiently or just want a minimalistic player that runs directly in your terminal, this guide will walk you through the process of installing cmus on Ubuntu step-by-step. Before starting, ensure you have a working internet connection and access to your Ubuntu terminal with sudo privileges.
What You’ll Need
- An Ubuntu system (preferably Ubuntu 20.04 or later) with administrative access
- Internet connection for downloading packages
- Basic familiarity with terminal commands
Step-by-Step
- Open your terminal: You can do this by pressing Ctrl + Alt + T or searching for “Terminal” in your application menu.
- Update your package list: Run the following command to ensure your system has the latest package information:
- Install cmus from the default Ubuntu repositories: Type the following command and press Enter:
- Verify the installation: Once the installation completes, check if cmus is correctly installed by typing:
- Launch cmus: Simply type
cmus
in the terminal and press Enter. This will open the cmus interface where you can start managing your music library.
- Configure your music library: By default, cmus scans your home directory for music. You can specify custom directories or add music to your library by navigating within cmus. To add directories, press 3 to go to the playlist view, then use the command :add /path/to/your/music inside cmus.
- Enjoy your music: Use the cmus controls to play, pause, skip, and manage your playlist. Refer to the official documentation or press ? within cmus for help commands.
sudo apt update
sudo apt install cmus
This command will download and install cmus along with any necessary dependencies.
cmus --version
If installed properly, the terminal will display the version number of cmus.
Common Mistakes
- Trying to install cmus from unofficial or outdated sources — always use Ubuntu’s official repositories with
apt. - Not updating package lists before installation — this can cause installation failures or outdated versions.
- Running cmus without proper permissions — ensure you run commands with
sudowhen necessary. - Not configuring the music directory — remember to add your music folders inside cmus to access your library.
- Ignoring dependencies or errors during installation — check error messages carefully and resolve missing dependencies if they occur.
Tips
- Customize your cmus setup: You can create configuration files in your home directory (~/.config/cmus/). Explore options like setting default directories, playback options, and key bindings.
- Use plugins and scripts: cmus supports various scripts and plugins to enhance functionality, such as visualizers or internet radio support.
- Learn keyboard shortcuts: cmus is designed for efficiency with shortcuts for common actions. Press ? inside cmus to access the help menu.
- Keep cmus updated: Use
sudo apt update && sudo apt upgraderegularly to get the latest features and security patches. - Combine with other tools: Use tools like
mpdorncmpcppfor extended control if needed, or integrate with system controls for seamless experience.
Troubleshooting
If you encounter issues during installation or while running cmus, here are some common solutions:
- Installation fails or package not found: Ensure your system is up-to-date with
sudo apt update. If problems persist, check if your Ubuntu version supports cmus or try installing from source. - cmus doesn’t recognize music files: Verify that the music files are in supported formats (MP3, FLAC, OGG, etc.). Ensure the directory path is correct and permissions are set properly.
- cmus crashes or behaves unexpectedly: Reset configuration files by deleting or renaming
~/.config/cmus/and restarting cmus. - Unable to add music or library not updating: Use the :add /path/to/music command within cmus and ensure the path exists and is accessible.
- Sound issues: Check your system’s audio settings, ensure your output device is correctly configured, and that no other applications are monopolizing audio resources.
Frequently Asked Questions
- Can I use cmus with my existing music library?
- Yes, cmus can scan and play music from directories on your system. Use the :add /path/to/music command inside cmus to include your library.
- Is cmus available for other Linux distributions?
- Absolutely. cmus is available for most Linux distros via package managers or can be compiled from source.
- Does cmus support streaming services?
- cmus primarily supports local files. However, with additional setup or scripts, it can be configured to stream internet radio or integrate with streaming services.
- How do I create playlists in cmus?
- You can create playlists by adding files to a playlist within cmus. Use the 7 key to switch to playlist view, then add or save playlists as needed.
- Can I control cmus with external hardware or scripts?
- Yes, cmus supports key bindings and can be controlled via scripts or external controllers for automation or remote control.
- Is cmus suitable for beginners?
- While it has a learning curve due to its command-line interface, its straightforward commands and help menu make it accessible for beginners willing to learn.
This comprehensive guide should help you install, configure, and troubleshoot cmus on your Ubuntu system so you can enjoy a powerful, lightweight music experience directly from your terminal.
Related
- Complete List of George Michael Albums in Chronological Order
- Complete List of Prince Albums in Chronological Order
- Complete List of David Bowie Albums in Chronological Order