NAME
ppooddccaasstt - Podcast Producer command line tool
SYNOPSIS
ppooddccaasstt [--sseerrvveerr serverhost] [--ppaassss password] [--uusseerr username]
[--cchheecckkssssllcceerrtt] [--ttiimmeeoouutt networktimeout]
[--aauutthh (Password | Kerberos)]
ppooddccaasstt --lliissttccaammeerraass
ppooddccaasstt --lliissttwwoorrkkfflloowwss
ppooddccaasstt --lliissttsseerrvveerrss
ppooddccaasstt --lliissttiinnffoo --sseerrvveerr serverhost
ppooddccaasstt --ssuubbmmiitt --ffiillee filepath [--ffiillee filepath] --wwoorrkkffllooww
workflowname [--mmeettaaddaattaa metadatafilepath]
[--uuppllooaaddbbuuffffeerrssiizzee buffersize]
ppooddccaasstt --lliissttuuppllooaaddss
ppooddccaasstt --cclleeaarrccoommpplleetteedduuppllooaaddss
ppooddccaasstt --iissbboouunndd
ppooddccaasstt --bbiinndd cameraname
ppooddccaasstt --uunnbbiinndd cameraname
ppooddccaasstt --pprreesseettss
ppooddccaasstt --ddeevviicceess
ppooddccaasstt --sseettccoonnffiigg key=value[;key=value]
ppooddccaasstt --ggeettccoonnffiigg
ppooddccaasstt --ssttaattuuss cameraname [--uuppddaatteepprreevviieeww]
ppooddccaasstt --ssttaarrtt cameraname [--aauuddiioooonnllyy] [--ddeellaayy seconds]
ppooddccaasstt --ssttoopp cameraname --mmeettaaddaattaa metadatafilepath --wwoorrkkffllooww
workflownameppooddccaasstt --ppaauussee cameraname
ppooddccaasstt --rreessuummee cameraname
ppooddccaasstt --ccaanncceell cameraname
ppooddccaasstt --hheellpp
CCOONNNNEECCTTIIVVIITTYY OOPPTTIIOONNSS[--sseerrvveerr serverhost] The location of the Podcast Producer
server. Format: 'myserver.exam-
ple.com' or 'https://myserver.exam-
ple.com:8170/podcastproducer'. If
omitted, podcast will use 'hostname'
[--uusseerr username] The username for authentication. If
omitted, podcast will use $USER
[--ppaassss password] The password for authentication. If
omitted, podcast will prompt for it
[--cchheecckkssssllcceerrtt] Validate server SSL certificate
[--ttiimmeeoouutt networktimeout] Specify a network timeout in seconds
(default is 60 seconds)[--aauutthh (Password | Kerberos)] Specify an authentication mechanism
to use when connecting to the PodcastProducer server. If omitted, podcast
will use 'Password' QQUUEERRYY OOPPEERRAATTIIOONNSS--lliissttccaammeerraass List available cameras
--lliissttwwoorrkkfflloowwss List available workflows
--lliissttsseerrvveerrss List available servers (Bonjour dis-
covery)--lliissttiinnffoo --sseerrvveerr serverhost List information about a specific
server (unauthenticated request) SSUUBBMMIISSSSIIOONN OOPPEERRAATTIIOONNSS--ssuubbmmiitt Submit a recording or a file
--ffiillee filepath Submit external file(s) (requires
-workflow)
--wwoorrkkffllooww workflowname The workflow to use for processing
(-file only)
[--mmeettaaddaattaa metadatafilepath] The metadata (XML plist) to use for
processing (-file only)
[--uuppllooaaddbbuuffffeerrssiizzee buffersize] Specifies the network transfer size
for an upload operation (default is 128K) UUPPLLOOAADD OOPPEERRAATTIIOONNSS--lliissttuuppllooaaddss Lists pending uploads and progress
status--cclleeaarrccoommpplleetteedduuppllooaaddss Clears completed uploads from list
AAGGEENNTT BBIINNDDIINNGG OOPPEERRAATTIIOONNSS--iissbboouunndd Check if the local camera agent is
bound to a server (returns 1 if bound, 0 if unbound)--bbiinndd cameraname Bind camera to a server
--uunnbbiinndd cameraname Remove binding for camera on a server
AAGGEENNTT CCOONNFFIIGGUURRAATTIIOONN OOPPEERRAATTIIOONNSS--pprreesseettss Lists available capture presets for
camera agent configuration--ddeevviicceess Lists available devices for camera
agent configuration--sseettccoonnffiigg key=value[;key=value] Write an agent configuration setting
(requires root)--ggeettccoonnffiigg Read agent configuration settings
(requires root) CCOONNFFIIGGUURRAATTIIOONN SSEETTTTIINNGGSS Capture Value is a ": " pair. Types: "Audio" or "Video" or "Screen" Qualities: "Good" or "Better" or "Best" AudioDevice Automatic | SysPref | Automatic will use the default audio device input. SysPref will use the audio device input from System Preferences. A specific will be used for audio (list devices with -devices)
VideoDevice Automatic |Automatic will use the default video device input. A specific will be used for video (list devices with -devices)
CCAAMMEERRAA CCOONNTTRROOLL OOPPEERRAATTIIOONNSS--ssttaattuuss cameraname [--uuppddaatteepprreevviieeww]
Get status of a specific remote cam-
era. Optionally, ask for the preview image to be updated--ssttaarrtt cameraname [--aauuddiioooonnllyy [--ddeellaayy seconds]]
Start capture on a specific remote camera. Optionally, start recording with audio only mode or with delay--ssttoopp cameraname Stop capture on a specific remote
camera (requires -workflow and
-metadata)
--ppaauussee cameraname Pause capture on a specific remote
camera--rreessuummee cameraname Resume capture on a specific remote
camera--ccaanncceell cameraname Cancel capture for a specific remote
camera HHEELLPP OOPPTTIIOONNSS--hheellpp Output a help listing
RETURN VALUES
Returns 0 if command completed successfully. Errors in the 10-19 range
are local command line issues. Errors in the 20-29 range are server con-
nectivity problems. Errors in the 30-39 range are server command prob-
lems. Errors numbered 40 and above are agent response errors. Returns 10 if root is required. Returns 11 if there was an error reading or writing to a Plist Returns 12 if there were command line parameter errors. Returns 20 if the server is unavailable. Returns 21 if there was a server hostname lookup failure. Returns 22 if there was a server timeout. Returns 23 if the server is not running SSL. Returns 24 if the server certificate is not valid (only with-checksslcert).
Returns 25 if there was a bad response from the server. Returns 26 if the server returned an authorization failure. Returns 30 if the submission create failed. Returns 31 if the upload server is unavailable. Returns 32 if the file upload failed. Returns 33 if the file copy failed. Returns 34 if the submission complete failed. Returns 35 if the agent bind failed on the server. Returns 36 if an agent command failed on the server. Returns 37 if an unknown server error occurred. CCOOMMMMAANNDD EEXXAAMMPPLLEESS List Workflows on the server:ppooddccaasstt --sseerrvveerr myserver.example.com --uusseerr username --ppaassss password
--lliissttwwoorrkkfflloowwss
Submit a third-party file to the server:
ppooddccaasstt --sseerrvveerr myserver.example.com --uusseerr username --ppaassss password
--ssuubbmmiitt --ffiillee /path/to/file --wwoorrkkffllooww 'Workflow1' --mmeettaaddaattaa
/path/to/metadata.plist Submit more than one file to the server:ppooddccaasstt --sseerrvveerr myserver.example.com --uusseerr username --ppaassss password
--ssuubbmmiitt --ffiillee /path/to/file1 --ffiillee /path/to/file2 --wwoorrkkffllooww
'Workflow1' --mmeettaaddaattaa /path/to/metadata.plist
Bind an agent to a server:ppooddccaasstt --sseerrvveerr myserver.example.com --uusseerr adminuser --ppaassss password
--bbiinndd 'MyCamera'
Write a set of configuration settings for the agent (requires root):ppooddccaasstt --sseettccoonnffiigg
'Capture=Video:Good;VideoDevice=iSight;AudioDevice=Automatic' Start a recording on a remote agent:ppooddccaasstt --sseerrvveerr myserver.example.com --uusseerr username --ppaassss password
--ssttaarrtt 'MyCamera'
Stop a recording on a remote agent:ppooddccaasstt --sseerrvveerr myserver.example.com --uusseerr username --ppaassss password
--ssttaarrtt 'MyCamera' --wwoorrkkffllooww 'Workflow1' --mmeettaaddaattaa
/path/to/metadata.plist OOUUTTPPUUTT EEXXAAMMPPLLEESSThis is example output from -listworkflows:
workflows name Workflow1 title Physics 13 Workflow description
Create podcast for Fall 2007 Physics 13 uuid
53F32376-B563-4A01-B481-120E9E337DB7 userrequirements Title Description name Workflow2 title Chemistry 5 Workflow description
Create podcast for Fall 2007 Chemistry 5 uuid
BBA1DB24-F6DE-475D-B51B-E7A780888F16 userrequirements Title Description This is example output from -listcameras:
MMEETTAADDAATTAA EEXXAAMMPPLLEESS cameras name WilderHallRoom102 uuid
A4640553-1C93-4FCD-98FE-917AF1700C6B previewurl
https://podcastproducer.voxclamantis.edu:8170/agentpreviews/A4640553-1C93-4FCD-98FE-917AF1700C6B.jpg name SteeleHallRoom006 uuid
B6DBECAC-3472-4692-B0FC-6143A46A7B53 previewurl
https://podcastproducer.voxclamantis.edu:8170/agentpreviews/B6DBECAC-3472-4692-B0FC-6143A46A7B53.jpg This is an example of a metadata file submitted with -metadata:
Mac OS December 21, 2019 Mac OS Author Professor Rick Hathaway Comment Strangely, things fall together. Sorry Yeats. Copyright Copyright (c) 2007 Vox Clamantis College Description Gravitation is a phenomenon through which all objects attract each other. Keywords gravitation phys13 Title
Lecture 4 - The theory of gravitation