OSX afplay command line audio player _manual_.

 
Thread Tools Search this Thread
Operating Systems OS X (Apple) OSX afplay command line audio player _manual_.
# 1  
Old 08-21-2016
OSX afplay command line audio player _manual_.

Hi everyone...

I don't know if this is the correct forum but it is Apple OSX specific.

It is a proper pseudo-man page for the sparse official one...

This is as thorough as experimentation can get...
Code:
Command line afplay, August 2016.
---------------------------------

afplay -h

Usage:
afplay [option...] audio_file

Options: (may appear before or after arguments)
  {-v | --volume} VOLUME
    set the volume for playback of the file
  {-h | --help}
    print help
  { --leaks}
    run leaks analysis
  {-t | --time} TIME
    play for TIME seconds
  {-r | --rate} RATE
    play at playback rate
  {-q | --rQuality} QUALITY
    set the quality used for rate-scaled playback (default is 0 - low quality, 1 - high quality)
  {-d | --debug}
    debug print output

===============================================================================
Example of usage, (assumes afplay is in the $PATH):-
  afplay -v 0.5 -t 1.0 -r 0.5 -q 0.5 -d /path/to/soundfile.ext

  The ".ext" CANNOT be raw, RAW, as afplay does not have the switches or flags to cope with it.

  -v is a floating point value between 0.0, volume minimum, and 1.0, volume maximum.
     This is NOT a linear scaling but relative to a logarithmic output volume level,
     so do NOT assume a value 0.5 is literally half volume.
  -t is an integer OR floating point value of arbitrary length inside the full playing time of
     the file to be played. Value 0.0 is the same as not have having the -t flag in the command,
     in other words it becomes disabled.
  -r is a floating point value of 0.0 or practical limits of about 0.4 to 3.0.
     It is not really a RATE change at all but plays almost _exactly_ the same as the original
     sound but at a quicker or slower _speed_, the _frequencies_ are not altered to any extent
     but the time taken to go through the whole file can create some humourous effects.
     A value of 0.0 disables the -r switch.
  -q is a floating point value between 0.0 and 1.0. The audible results are purely subjective on
     a music file that has huge amounts of amplitude compression, ("LOUDNESS WARS" anyone?),
     so don't expect too much from this switch.
  -d is not really debug in its entirety but also a verbose mode and gives some technical data
     about the file being played.
  -- leaks is certainly a debug mode but requires username and password to give a file something
     like below:-
"""
Memory leak analysis of afplay (pid 497):
An admin user name and password is required to enter Developer Mode.
Admin user name (myhomefolder): myhomefolder
Password:
2016-08-19 13:40:55.587 leaks[499:4803] *** Symbolication:  libsystem_c.dylib
is the same in the target process as in the analysis process, but it was loaded
at a different address.  That means the dyld shared cache is not up to date,
which could affect system performance.  To update the dyld shared cache, run
'sudo update_dyld_shared_cache' and reboot.

Process:         afplay [497]
Path:            /usr/bin/afplay
Load Address:    0x104bcf000
Identifier:      afplay
Version:         ??? (???)
Code Type:       X86-64 (Native)
Parent Process:  bash [454]

Date/Time:       2016-08-19 13:40:55.307 +0100
OS Version:      Mac OS X 10.7.5 (11G63)
Report Version:  7

leaks Report Version:  2.0
Process 497: 4447 nodes malloced for 574 KB
Process 497: 0 leaks for 0 total leaked bytes.
"""
===============================================================================

  And finally......
  -h the quick help file at the top.

  The player is capable or playing a number of formats:-
  WAV, AAC, MP3, M4A, AIFC just to name but a few.
  A rawfile, RAW, is NOT catered for see above.

  A practical example:-
  This plays a time limited 1 second playable file at slightly reduced volume and at a slightly quicker
  speed where the quality is supposedly better than the default low and creates a verbose echo to screen.
"""
MyPrompt> afplay -v 0.5 -t 1 -r 1.5 -q 0.5 -d /Users/myhomefolder/Movies/test.aifc
Playing file: /Users/myhomefolder/Movies/test.aifc
Playing format: AudioStreamBasicDescription:  2 ch,  44100 Hz, 'lpcm' (0x0000000E) 24-bit big-endian signed integer
Buffer Byte Size: 132300, Num Packets to Read: 22050
Enable rate-scaled playback (rate = 1.50) using Time Domain algorithm
"""

I hope this is of help to all those new to the afplay command line audio player.

Login or Register to Ask a Question

Previous Thread | Next Thread

4 More Discussions You Might Find Interesting

1. OS X (Apple)

A new OSX 10.12.x terminal from the command line.

Hi guys and gals... After much searching on the good ol' internet I could find nothing, so this is the result. ALthough many people seem to have asked this question no-one seems to have a solution so here we go. I need for AudioScope.sh, 'xterm' to run a second program for some of its... (2 Replies)
Discussion started by: wisecracker
2 Replies

2. OS X (Apple)

OSX Sierra transparent shell audio sampler.

Well after the transparent QuickTime Player means of capture for OSX 10.7.x became broken in at least Yosemite I decided to persevere with a version of command line capture for OSX 10.12.x. A derivative of this DEMO is now inside AudioScope.sh to give my MBP and iMac a means of capturing an... (3 Replies)
Discussion started by: wisecracker
3 Replies

3. UNIX for Dummies Questions & Answers

ffmpeg: capture audio that's playing (command line)

I'd like to capture the audio playing in itunes (OSX) to a file (from the command line). I currently use Wiretap Pro, but i'd like a non-gui. I tried installing sox, but after installing about 40-50 dependencies it crashed out. I do have ffmpeg working and I am pretty sure it can capture what's... (0 Replies)
Discussion started by: sentinel
0 Replies

4. OS X (Apple)

osx mp3 player help

Hey UNIX Saviors, I am not very familiar with unix commands so I need some detailed help please. I have a RCA Lyra MP3 player that is supposed to work as a drag and drop external drive when transferring my MP3's. In OSX, the problem is that when I delete the MP3 from the mounted drive it... (1 Reply)
Discussion started by: eideas
1 Replies
Login or Register to Ask a Question