Hi.
When working with PulseAudio on the command line I really miss
completion for it so I've written this zsh completion.
I'm not sure if this should be part of PulseAudio or zsh, but
seeing that systemd ships its own completion, I assume that it
should be fine here.
Btw I'm not sure if I've modified the Makefile correctly.
Patch attached.
-------------- next part --------------
>From 1b20109e864305154505370ca5a9d491fb9e0c66 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?poljar=20=28Damir=20Jeli=C4=87=29?= <poljarinho@xxxxxxxxx>
Date: Sat, 19 Jan 2013 17:07:59 +0100
Subject: [PATCH] build: Add zsh completion
This patch adds zsh completion for pulseaudio and all of the utilities.
Channel maps and properties are not yet completed.
This should make mostly pactl/pacmd more usefull for zsh users.
---
Makefile.am | 1 +
shell-completion/pulseaudio-zsh-completion.zsh | 486 +++++++++++++++++++++++++
2 files changed, 487 insertions(+)
create mode 100644 shell-completion/pulseaudio-zsh-completion.zsh
diff --git a/Makefile.am b/Makefile.am
index 09fe5ef..dbaaa95 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -33,6 +33,7 @@ EXTRA_DIST = \
vala/libpulse.vapi \
vala/libpulse-mainloop-glib.deps \
vala/libpulse-mainloop-glib.vapi \
+ shell-completion/pulseaudio-zsh-completion.zsh \
.gitignore \
doxygen/.gitignore \
m4/.gitignore \
diff --git a/shell-completion/pulseaudio-zsh-completion.zsh b/shell-completion/pulseaudio-zsh-completion.zsh
new file mode 100644
index 0000000..c3baf9d
--- /dev/null
+++ b/shell-completion/pulseaudio-zsh-completion.zsh
@@ -0,0 +1,486 @@
+#compdef pulseaudio pactl pacmd pacat paplay parecord padsp pasuspender
+
+_devices() {
+ local -a _device_list
+ local cmd _device _device_description
+
+ if [[ $service == pactl || $service == pacmd ]]; then
+ case $words[$((CURRENT - 1))] in
+ set-sink-input-*) cmd=('sink-inputs');;
+ set-sink-*) cmd=('sinks');;
+ set-source-output-*) cmd=('source-outputs');;
+ set-source-*) cmd=('sources');;
+ suspend-sink) cmd=('sinks');;
+ suspend-source) cmd=('sources');;
+ move-sink-input) cmd=('sink-inputs');;
+ move-source-output) cmd=('source-outputs');;
+ kill-sink-input) cmd=('sink-inputs');;
+ kill-source-output) cmd=('source-outputs');;
+ esac
+
+ case $words[$((CURRENT - 2))] in
+ move-sink-input) cmd=('sinks');;
+ move-source-output) cmd=('sources');;
+ esac
+
+ elif [[ $service == (pacat|paplay|parecord) ]]; then
+ if [[ $words == *-r[[:space:]]* ]]; then
+ cmd=('sources')
+ elif [[ $words == *-p[[:space:]]* ]]; then
+ cmd=('sinks')
+ else
+ cmd=('sinks' 'sources')
+ fi
+
+ elif [[ $service == paplay ]]; then
+ cmd=('sinks')
+ elif [[ $service == parecord ]]; then
+ cmd=('sources')
+ fi
+
+ for target in $cmd; do
+ for device_info in ${(ps:\n\n:)"$(_call_program card_tag "pactl list $target")"}; do
+ for line in ${(f)device_info}; do
+ if [[ $target == (sink-inputs|source-outputs) ]]; then
+ if [[ $line == (Sink*Input|Source*Output)* ]]; then
+ _device=${line#*\#}
+ elif [[ $line == *application.name* ]]; then
+ _device_description=${line#*= }
+ fi
+
+ else
+ if [[ $words[$((CURRENT - 1))] == *set-sink-formats* ]]; then
+ if [[ $line == Sink* ]]; then
+ _device=${line#*\#}
+ elif [[ $line == *Description:* ]]; then
+ _device_description=${line#*: }
+ fi
+
+ else
+ if [[ $line == *Name:* ]]; then
+ _device=${line#*: }
+ elif [[ $line == *Description:* ]]; then
+ _device_description=${line#*: }
+ fi
+ fi
+ fi
+ done
+ _device_list+=($_device:$_device_description)
+ done
+ done
+
+ _describe 'device list' _device_list
+}
+
+_profiles() {
+ local -a _profile_list
+ local _current_card _raw_profiles _profile_name _profile_description
+
+ _current_card=$words[$((CURRENT - 1))]
+
+ for card in ${(ps:\n\n:)"$(_call_program card_tag "pactl list cards")"}; do
+ if [[ $card == *$_current_card* ]]; then
+ _raw_profiles=${card##*Profiles:}
+ _raw_profiles=${_raw_profiles%%Active Profile:*}
+ for profile in ${(f)_raw_profiles}; do
+ if [[ $profile != [[:blank:]] ]]; then
+ _profile_name=${profile%%: *}
+ _profile_name=${_profile_name//[[:blank:]]/}
+ _profile_name=${_profile_name//:/\\:}
+ _profile_description=${profile#*: }
+ _profile_list+=($_profile_name:$_profile_description)
+ fi
+ done
+ fi
+ done
+
+ _describe 'profile list' _profile_list
+}
+
+_ports() {
+ local -a _port_list
+ local _raw_ports _port_name _port_description _current_device
+
+ case $words[$((CURRENT - 2))] in
+ set-sink-port) cmd="sinks";;
+ set-source-port) cmd="sources";;
+ set-port-latency-offset) cmd="cards";;
+ esac
+
+ _current_device=$words[$((CURRENT - 1))]
+
+ for device in ${(ps:\n\n:)"$(_call_program card_tag "pactl list $cmd")"}; do
+ if [[ $device == *Ports:* && $device == *$_current_device* ]]; then
+ _raw_ports=${device##*Ports:}
+ _raw_ports=${_raw_ports%%Active Port:*}
+ for line in ${(f)_raw_ports}; do
+ if [[ $line != [[:blank:]] &&
+ $line != (*Part?of*|*Properties:*|*device.icon_name*) ]]; then
+ _port_name=${line%%: *}
+ _port_name=${_port_name//[[:blank:]]/}
+ _port_description=${line#*: }
+ _port_list+=($_port_name:$_port_description)
+ fi
+ done
+ fi
+ done
+
+ _describe 'port list' _port_list
+}
+
+_cards(){
+ local -a _card_list
+ local _card _cad_name
+ for card_info in ${(ps:\n\n:)"$(_call_program card_tag "pactl list cards")"}; do
+ for line in ${(f)card_info}; do
+ if [[ $line == *Name:* ]]; then
+ _card=${line#*: }
+ elif [[ $line == *alsa.long_card_name* ]]; then
+ _card_name=${line#*= \"}
+ _card_name=${_card_name%at*}
+ fi
+ done
+ _card_list+=($_card:$_card_name)
+ done
+
+ _describe 'card list' _card_list
+}
+
+_all_modules(){
+ local -a _all_modules_list
+ for module in ${(f)"$(_call_program modules_tag "pulseaudio --dump-modules")"}; do
+ _all_modules_list+=${module%% *}
+ done
+ _describe 'module list' _all_modules_list
+}
+
+_loaded_modules(){
+ local -a _loaded_modules_list
+ for module in ${(f)"$(_call_program modules_tag "pactl list modules short")"}; do
+ _loaded_modules_list+=(${${(ps:\t:)module}[1]}:${${(ps:\t:)module}[2]})
+ done
+ _describe 'module list' _loaded_modules_list
+}
+
+_resample_methods() {
+ local -a _resample_method_list
+ for method in ${(f)"$(_call_program modules_tag "pulseaudio --dump-resample-methods")"}; do
+ _resample_method_list+=$method
+ done
+ _describe 'resample method list' _resample_method_list
+}
+
+_clients() {
+ local -a _client_list
+ local _client _client_description
+ for client_info in ${(ps:\n\n:)"$(_call_program card_tag "pactl list clients")"}; do
+ for line in ${(f)client_info}; do
+ if [[ $line == Client[[:space:]]#* ]]; then
+ _client=${line#*\#}
+ elif [[ $line == *application.name* ]]; then
+ _client_description=${line#*=}
+ fi
+ done
+ _client_list+=($_client:$_client_description)
+ done
+ _describe 'client list' _client_list
+}
+
+_pacat_file_formats() {
+ local -a _file_format_list
+ for format in ${(f)"$(_call_program modules_tag "pacat --list-file-formats")"}; do
+ _file_format_list+=(${${(ps:\t:)format}[1]}:${${(ps:\t:)format}[2]})
+ done
+ _describe 'file format list' _file_format_list
+}
+
+_pactl_completion() {
+ _pactl_command(){
+ _pactl_commands=(
+ 'help: show help and exit'
+ 'stat: dump statistics about the PulseAudio daemon'
+ 'info: dump info about the PulseAudio daemon'
+ 'list: list modules/sources/streams/cards etc...'
+ 'exit: ask the PulseAudio daemon to exit'
+ 'upload-sample: upload a sound from a file into the sample cache'
+ 'play-sample: play the specified sample from the sample cache'
+ 'remove-sample: remove the specified sample from the sample cache'
+ 'load-module: load a module'
+ 'unload-module: unload a module'
+ 'move-sink-input: move a stream to a sink'
+ 'move-source-output: move a recording stream to a source'
+ 'suspend-sink: suspend or resume a sink'
+ 'suspend-source: suspend or resume a source'
+ 'set-card-profile: set a card profile:cards:_cards'
+ 'set-sink-port: set the sink port of a sink'
+ 'set-source-port: set the source port of a source'
+ 'set-port-latency-offset: set a latency offset on a port'
+ 'set-sink-volume: set the volume of a sink'
+ 'set-source-volume: set the volume of a source'
+ 'set-sink-input-volume: set the volume of a stream'
+ 'set-source-output-volume: set the volume of a recording stream'
+ 'set-sink-mute: mute a sink'
+ 'set-source-mute: mute a source'
+ 'set-sink-input-mute: mute a stream'
+ 'set-source-output-mute: mute a recording stream'
+ 'set-sink-formats: set supported formats of a sink'
+ 'subscribe: subscribe to events'
+ )
+ _describe 'pactl commands' _pactl_commands
+ }
+
+ _pactl_list_commands=(
+ 'modules: list loaded modules'
+ 'sinks: list available sinks'
+ 'sources: list available sources'
+ 'sink-inputs: list connected sink inputs'
+ 'source-outputs: list connected source outputs'
+ 'clients: list connected clients'
+ 'samples: list samples'
+ 'cards: list available cards'
+ )
+
+ _arguments -C \
+ - '(help)' \
+ {-h,--help}'[display this help and exit]' \
+ '--version[show version and exit]' \
+ - '(server)' \
+ {-s,--server}'[name of server to connect to]:host:_hosts' \
+ - '(name)' \
+ {-n,--client-name}'[client name to use]:name' \
+ '::pactl commands:_pactl_command' \
+
+ case $words[$((CURRENT - 1))] in
+ list) _describe 'pactl list commands' _pactl_list_commands;;
+ stat) compadd short;;
+ set-card-profile) _cards;;
+ set-sink-*) _devices;;
+ set-source-*) _devices;;
+ upload-sample) _files;;
+ load-module) _all_modules;;
+ unload-module) _loaded_modules;;
+ suspend-*) _devices;;
+ move-*) _devices;;
+ set-port-latency-offset) _cards;;
+ esac
+
+ case $words[$((CURRENT - 2))] in
+ set-card-profile) _profiles;;
+ set-(sink|source)-port) _ports;;
+ set-port-latency-offset) _ports;;
+ set-*-mute) compadd true false;;
+ suspend-*) compadd true false;;
+ list) compadd short;;
+ move-*) _devices;;
+ '-s' | '-n') _pactl_command;;
+ --server | --client-*) _pactl_command;;
+ esac
+}
+
+_pacmd_completion() {
+ _pacmd_command(){
+ _pacmd_commands=(
+ 'help: show help and exit'
+ 'list-modules: list modules'
+ 'list-sinks: list sinks'
+ 'list-sources: list sources'
+ 'list-clients: list clients'
+ 'list-sink-inputs: list sink-inputs'
+ 'list-source-outputs: list source-outputs'
+ 'stat: dump statistics about the PulseAudio daemon'
+ 'info: dump info about the PulseAudio daemon'
+ 'load-module: load a module'
+ 'unload-module: unload a module'
+ 'describe-module: print info for a module'
+ 'set-sink-volume: set the volume of a sink'
+ 'set-source-volume: set the volume of a source'
+ 'set-sink-mute: mute a sink'
+ 'set-source-mute: mute a source'
+ 'set-sink-input-volume: set the volume of a stream'
+ 'set-source-output-volume: set the volume of a recording stream'
+ 'set-sink-input-mute: mute a stream'
+ 'set-source-output-mute: mute a recording stream'
+ 'set-default-sink: set the default sink'
+ 'set-default-source: set the default source'
+ 'set-card-profile: set a card profile'
+ 'set-sink-port: set the sink port of a sink'
+ 'set-source-port: set the source port of a source'
+ 'set-port-latency-offset: set a latency offset on a port'
+ 'suspend-sink: suspend or resume a sink'
+ 'suspend-source: suspend or resume a source'
+ 'suspend: suspend all sinks and sources'
+ 'move-sink-input: move a stream to a sink'
+ 'move-source-output: move a recording stream to a source'
+ 'update-sink-proplist: update the properties of a sink'
+ 'update-source-proplist: update the properties of a source'
+ 'update-sink-input-proplist: update the properties of a sink-input'
+ 'update-source-output-proplist: update the properties of a source-output'
+ 'list-samples: list samples'
+ 'play-sample: play the specified sample from the sample cache' # TODO
+ 'remove-sample: remove the specified sample from the sample cache' # TODO
+ 'load-sample: upload a sound from a file into the sample cache'
+ 'load-sample-lazy: lazily upload a sound file into the sample cache'
+ 'load-sample-dir-lazy: lazily upload all sound files in a directory into the sample cache'
+ 'kill-client: kill a client'
+ 'kill-sink-input: kill a sink input'
+ 'kill-source-output: kill a source output'
+ 'set-log-target: change the log target'
+ 'set-log-level: change the log level'
+ 'set-log-meta: show source code location in log messages'
+ 'set-log-time: show timestamps in log messages'
+ 'set-log-backtrace: show backtrace in log messages'
+ 'play-file: play a sound file'
+ 'dump: show daemon configuration'
+ 'dump-volumes: show the state of all volumes'
+ 'shared: show shared properties'
+ 'exit: ask the PulseAudio daemon to exit'
+ )
+ _describe 'pacmd commands' _pacmd_commands
+ }
+
+ _arguments -C \
+ - '(help)' \
+ {-h,--help}'[display this help and exit]' \
+ '--version[show version and exit]' \
+ '::pacmd commands:_pacmd_command' \
+
+ case $words[$((CURRENT - 1))] in
+ set-card-profile) _cards;;
+ set-sink-*) _devices;;
+ set-source-*) _devices;;
+ load-module) _all_modules;;
+ describe-module) _all_modules;;
+ unload-module) _loaded_modules;;
+ suspend-*) _devices;;
+ move-*) _devices;;
+ set-port-latency-offset) _cards;;
+ load-sample*) _files;;
+ kill-client) _clients;;
+ kill-(sink|source)-*) _devices;;
+ set-log-target) compadd null auto syslog stderr file:;;
+ set-log-*) compadd true false;;
+ play-file) _files;;
+ esac
+
+ case $words[$((CURRENT - 2))] in
+ set-card-profile) _profiles;;
+ set-(sink|source)-port) _ports;;
+ set-port-latency-offset) _ports;;
+ set-*-mute) compadd true false;;
+ suspend-*) compadd true false;;
+ move-*) _devices;;
+ esac
+}
+
+_pasuspender_completion() {
+ _arguments -C \
+ {-h,--help}'[display this help and exit]' \
+ '--version[show version and exit]' \
+ {-s,--server}'[name of server to connect to]:host:_hosts' \
+}
+
+_padsp_completion() {
+ _arguments -C \
+ '-h[display this help and exit]' \
+ '-s[name of server to connect to]:host:_hosts' \
+ '-n[client name to use]:name:' \
+ '-m[stream name to use]:name:' \
+ '-M[disable /dev/mixer emulation]' \
+ '-S[disable /dev/sndstat emulation]' \
+ '-D[disable /dev/dsp emulation]' \
+ '-d[enable debug output]' \
+ '--[disable further command line parsing]' \
+}
+
+# TODO channel map completion
+_pacat_completion() {
+ _pacat_sample_formats=('s16le' 's16be' 'u8' 'float32le' 'float32be'
+ 'ulaw' 'alaw' 's32le' 's32be' 's24le' 's24-32le' 's24-32be')
+
+ _arguments -C \
+ {-h,--help}'[display this help and exit]' \
+ '--version[show version and exit]' \
+ {-r,--record}'[create a connection for recording]' \
+ {-p,--playback}'[create a connection for playback]' \
+ {-s,--server=}'[name of server to connect to]:host:_hosts' \
+ {-d,--device=}'[name of sink/source to connect to]:device:_devices' \
+ {-n,--client-name=}'[client name to use]:name' \
+ '--stream-name=[how to call this stream]:name' \
+ '--volume=[initial volume to use]:volume' \
+ '--rate=[sample rate to use]:rate:(44100 48000 96000)' \
+ '--format=[sample type to use]:format:((${(q)_pacat_sample_formats}))' \
+ '--channels=[number of channels to use]:number:(1 2)' \
+ '--channel-map=[channel map to use]:map' \
+ '--fix-format[use the sample format of the sink]' \
+ '--fix-rate[use the rate of the sink]' \
+ '--fix-channels[channel map of the sink]' \
+ '--no-remix[do not upmix or downmix channels]' \
+ '--no-remap[map channels by index instead of name]' \
+ '--latency=[request the specified latency]:bytes' \
+ '--process-time=[request the specified process time]:bytes' \
+ '--latency-msec=[request the specified latency in msec]:msec' \
+ '--process-time-msec=[request the specified process time in msec]:msec' \
+ '--property=[set the specified property]:property' \
+ '--raw[record/play raw PCM data]' \
+ '--passthrough[passtrough data]' \
+ '--file-format[record/play formatted PCM data]:format:_pacat_file_formats' \
+ '--list-file-formats[list available formats]' \
+}
+
+# TODO log-target file completion
+_pulseaudio_completion() {
+ _arguments -C \
+ {-h,--help}'[display this help and exit]' \
+ '--version[show version and exit]' \
+ '--dump-conf[show default configuration]' \
+ '--dump-modules[show available modules]' \
+ '--dump-resample-methods[show available resample methods]' \
+ '--cleanup-shm[cleanup shared memory]' \
+ '--start[start the daemon]' \
+ {-k,--kill}'[kill a running daemon]' \
+ '--check[check for a running daemon]' \
+ '--system=[run as systemd-wide daemon]:bool:(true false)' \
+ {-D,--daemonize=}'[daemonize after startup]:bool:(true false)' \
+ '--fail=[quit when startup fails]:bool:(true false)' \
+ '--high-priority=[try to set high nice level]:bool:(true false)' \
+ '--realtime=[try to enable rt scheduling]:bool:(true false)' \
+ '--disallow-module-loading=[disallow module loading]:bool:(true false)' \
+ '--disallow-exit=[disallow user requested exit]' \
+ '--exit-idle-time=[terminate the daemon on passed idle time]:time' \
+ '--scache-idle-time=[unload autoloaded samples on passed idle time]:time' \
+ '--log-level=[set the verbosity level]:level' \
+ '-v[increase the verbosity level]' \
+ '--log-target=[set the log target]:target:(auto syslog stderr file\: new_file\:):file' \
+ '--log-meta=[include code location in log messages]:bool:(true false)' \
+ '--log-time=[include timestamps in log messages]:bool:(true false)' \
+ '--log-backtrace=[include backtrace in log messages]:frames' \
+ {-p,--dl-search-path=}'[set the search path for plugins]:dir:_files' \
+ '--resample-method=[set the resample method]:method:_resample_methods' \
+ '--use-pid-file=[create a PID file]:bool:(true false)' \
+ '--no-cpu-limit=[do not install CPU load limiter]:bool:(true false)' \
+ '--disable-shm=[disable shared memory support]:bool:(true false)' \
+ {-L,--load=}'[load the specified module]:modules:_all_modules' \
+ {-F,--file=}'[run the specified script]:file:_files' \
+ '-C[open a command line on the running tty]' \
+ '-n[do not load the default script file]' \
+}
+
+_pulseaudio() {
+ local state line curcontext="$curcontext"
+
+ case $service in
+ pulseaudio) _pulseaudio_completion;;
+ pactl) _pactl_completion;;
+ pacmd) _pacmd_completion;;
+ pacat) _pacat_completion;;
+ paplay)_pacat_completion;;
+ parecord)_pacat_completion;;
+ padsp) _padsp_completion;;
+ pasuspender) _pasuspender_completion;;
+ *) _message "Err";;
+ esac
+}
+
+_pulseaudio "$@"
+
+#vim: set ft=zsh sw=4 ts=4 noet
--
1.8.1.1
