Command Line Audio players: mpg321 and mpg123

21 February 2006

The classic audio players for the command line are of course mpg321 and mpg123. These two players are more or less identical when it comes to using them. I'm not 100% sure of the historical facts here but it here is the story as I understand it. If you know better then please leave a comment below.

The history of mpg321 and mpg123

mpg123 was one of the first ever mp3 players, but it was under a non-free licence, so mp321 was created to replace it. Later on mpg123 would be released under a free licence too, but by then everyone already had moved over to mpg321 and that seems to be the actively developed one. According to Joe Drew, the author of mpg321:

mpg123 is very popular because of its relative simplicity and its general facility. It is very good at what it does. It is, however, under a non-free license: you can't incorporate its code into your own without getting special permission, and commercial entities also need special permission just to use it.

Being a Free Software advocate, I saw a deficiency in the dependency many people had on mpg123. Therefore, I created mpg321, and as more features of mpg123 are implemented, it becomes less and less likely that anyone will need mpg123 for anything any more.

So let us continue with mpg321.

Using mpg321

Using mpg321 could not be any simplier, you simply type mpg321 and then the name of the file or files that you want to play. Below is mpg321 in action, here I am just using the wildcard to play all the songs in the directory (in alphabetical order):

# mpg321 *
High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2, and 3.
Version 0.59q (2002/03/23). Written and copyrights by Joe Drew.
Uses code from various people. See 'README' for more!
THIS SOFTWARE COMES WITH ABSOLUTELY NO WARRANTY! USE AT YOUR OWN RISK!
Title : Sync or swim Artist: Artemis
Album : Gravity Year : 2005
Comment: Magnatune.com Genre : Pop

Playing MPEG stream from 001_01-Sync or swim-Artemis.mp3 ...
MPEG 1.0 layer III, 128 kbit/s, 44100 Hz stereo

If you do not want all that text output, then use mpg321 -q filename. If you want more info, such as the time remaining etc, then use mpg321 -v.

Using mpg123

As you might expect, mpg123 works exactly the same, apart from the version number and the author, usage is exactly the same.

# mpg123 *
High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2 and 3.
Version 0.59s-r9 (2000/Oct/27). Written and copyrights by Michael Hipp.

Uses code from various people. See 'README' for more!
THIS SOFTWARE COMES WITH ABSOLUTELY NO WARRANTY! USE AT YOUR OWN RISK!
Title : Sync or swim Artist: Artemis
Album : Gravity Year : 2005

Comment: Magnatune.com Genre : Pop``

Playing MPEG stream from 001_01-Sync or swim-Artemis.mp3 ...
Found new ID3 Header
MPEG 1.0 layer III, 128 kbit/s, 44100 Hz stereo

Playlists

You may already be thinking to yourself, 'thats nice but what about playlists?' Well mpg321 has fantastic playlist support. To create a playlist just make a text file of your songs. For example, this is how I do it:

ls *.mp3 > songs.playlist.txt

ls | grep Artemis > artemis.playlist.txt

You can then edit the order using your favourite text editor, e.g. Emacs/Vi/Nano.

To play the list just use the --list or -@ option:

mpg321 --list artemis.txt

Life is Random

To make things more fun, mpg321 has two shuffle modes; little shuffle and big shuffle.

In little shuffle mode, mpg321 plays every file once in a random order. So it sorts the files you have specified (directly or through playlists) and produces a random order and plays it, stopping when you run out of files.

mpg321 -z --list artemis.txt

In big shuffle mode, mpg321 plays a random file and then plays another random file. mpg321 will go on until you stop it. This is great for jukebox style play, and when you just want a soundtrack to whatever else you are doing.

mpg321 -Z *

Further uses

Because mpg321 follows all the normal bash conventions, it is very easy to use in simple bash scripts, the only limit is your imagination. If you think of a novel use, then please do let us now in a comment below.

Links

1 Lou Gogan says...

Hi

Enjoy learning from your pages. There seems to be problems with the css <code> formatting - some of the text goes on and on - on the one line rather than wrapping. There also seems to be a problem with the line height of the css <code> formatting. Am using Firefox on Ubuntu Linux.

Thought I'd let you know.

Keep up the good work !

Lou Gogan

Posted at 6:27 p.m. on April 22, 2008


2 http://andry.mine.nu says...

To create play list better use:

# find /mnt/music/??????/ -name *.mp3 >> /home/andry/playlist.txt

System Message: WARNING/2 (<string>, line 3); backlink

Inline emphasis start-string without end-string.

it will add files to playlist recursive from ?????? folder.

Posted at 2:51 a.m. on October 8, 2008


What do you have to say?

Show Editing Help

About

Hello, my name is Zeth, I'll be your host here.

Command Line Warriors is about taking control of your own technology, it looks at our experiences of computing; especially using GNU/Linux, the Python programming language, the command-line and issues such as techno-ethics, best practices and whatever is cool now. If you take control of your technology then you are a Warrior too!

This site is your site too which means that you can contribute and get involved. You can leave comments using the facility provided. For me, the comments and discussions are by far the best part of the site. So please do have your say!

Latest Discussions

Zeth

November 29, 2009
Hi Jordan, yes that URL is gone now. I have a new contact form on this site.
Python CGI contact forms

Jordan

November 29, 2009
Zeth attention! Your form, http://zeth.me.uk/contact/, is not working The explorer says connecting ..but nothing happens Sorry for my poor English: I am Spanish Regards
Python CGI contact forms

Jordan

November 26, 2009
Sorry: tell me , not tellme (I'm spaniard) And http://zeth.me.uk/contact/ don't work
You got the touch, you got the power

David Jones

November 25, 2009
Your mad skillz are too l33t! for me. I specifically switched to Google Reader so that I could show people what blogs I read. But I couldn't work out how ...
How to find the fashionable blogs quickly

Brian R. Hickey

November 20, 2009
Symantec picked it up too.
How to bring down Internet Explorer with six words

Zeth

November 17, 2009
Thanks djm, I am the moose here. Christian, assuming one actually does Internationalise the countries, it should still work I guess, as the gettext stuff will happen before the list ...
Countries in Django

Phillip Temple

November 17, 2009
Good start, but: a) wouldn't I want None back rather than 'ZZ'? b) why not add a 'shortcut' boolean, then prepend flagged fields (plus usual '-----' separator) to the actual ...
Countries in Django

djm

November 17, 2009
Am I being a moose or did you mean: from whatever.countries import CountryField instead of from whatever.countries import CharField ? Good post though, cheers.
Countries in Django

Christian Joergensen

November 17, 2009
Wouldn't the ordering get messed up after i18n?
Countries in Django

Steve - Electronic Cigarettes Fan

November 17, 2009
Very well done. Is your blog just you writing? Nicely done, Steven.
Blogger vs Wordpress

vetetix

November 15, 2009
Sorry to bother you nearly two years after you wrote this blog article, but I can't manage to find how to modify an existing field. I am trying to change ...
Three Useful Python Bindings - ClamAV, Apt and Evolution

Manju

November 4, 2009
I am transferring some files using psftp to other device's FAT partition. But the filestamp of the file being transferred is modified to that of FAT device, after the transfer. ...
PuTTY Series: Using PSFTP

iki

November 2, 2009
or simpler: socket.gethostbyname_ex(socket.gethostname())[2]
How to find out your IP address in Python

iki

November 2, 2009
local_ip = set([ i[4][0] for i in socket.getaddrinfo(socket.gethostname(), None) if i[0] == 2 ])
How to find out your IP address in Python

Fred

November 2, 2009
testing rst ------------- - point 1
An Introduction to ReStructuredText

Ano

October 27, 2009
"You simply found the license of the StumbleUpon Toolbar for Internet Explorer." That's possible. I've got some more interesting information to add. Firstly, go to this page: https://addons.mozilla.org/en-US/firefox/addon/138 - this ...
Are your Firefox extensions proprietary software?

Ken

October 21, 2009
Stumbled in here at lunch. This is the best find of the week. Thanks.
Three classic command line tips

Jim

October 19, 2009
Thanks for the rtsp:// post - that's something that has been bugging me for a while!
Three classic command line tips

Zeth

October 18, 2009
Thanks for the comments guys. Great to see the all the gang are still here!
Three classic command line tips

Bubba

October 18, 2009
Is there any way psftp can return the true transfer rates oberved during the actual transfer?
PuTTY Series: Using PSFTP