mcvideo

a Windows command line tool to display video clips

A main purpose of mcvideo is displaying a clip from local disc or URL location at specific place and desired size on the desktop.

Mcvideo was fought to be easy integrated with window management software like Datapath Wall Control or Jupiter ControlPoint.

Mcvideo runs on any Windows system, but requires .NET Framework version 2.0 instaled on it.
It's based on Media Player control and requires minimum Media Player 9 installed. It is recommended to download a fresh Media Player from Microsoft. No codecs are included with mcvideo. It uses codecs instaled on system.

Mcvideo is free for personal use. Contact office@infotechnika.pl to obtain a commercial copy.

NAME

mcvideo - a command line tool for displaying video clips

DESCRIPTION

Mcvideo is a command line tool for displaying video anywhere on screen at any size. All program functionality can be accessed from command line options. Video can be local file, DVD or remote using http:// or rtsp:// protocols. Video size and position can be controlled by command line arguments or by other programs e.g. Wall Control

SYNOPSIS

mcvideo.exe [options]

OPTIONS

-href=videoLocation
The program accepts http://, rtsp:// requests, local paths (full and relative) or local DVD drives.
For HTTP request use -href=http://video_address syntax (like -href=http://mirrorblender.top-ix.org/peach/bigbuckbunny_movies/big_buck_bunny_480p_stereo.ogg).
For RTSP streams use -href=rtsp://video_rtsp_address (like -href=rtsp://91.121.87.29/bociany)
For local requests use -href=file:///full_video_path syntax (-href=file:///d:/test/02_001.avi) or -href=full_video_path (-href=d:/test/02_001.avi).
For relative paths use -href=relative_video_path syntax (-href=demo.avi)
To access a movie from local DVD drive use wmpdvd://drive/title/chapter syntax
The drive segment is the letter of the DVD drive (without usual colon) and is always required.
The title segment is the number of the title to play. It is not required unless you want to start playback at a specific title. The chapter segment is the number of the chapter to play. It is not required unless you want to start playback at a specific chapter of a specific title. Examples:
mcvideo -href=wmpdvd://X -plays media from local DVD (X:) drive
mcvideo -href=wmpdvd://F/1/5 -plays title 1, chapter 5 from local DVD (D:) drive

-source=videoList
Use -source option to specify multiple video clips to be played one after another. It works like a playlist. The source value must be a directory path where mcvideo will look for videos like -source=c:\videos\ (with or without ending backslash).

-title=videoTitle
video title displayed on title bar

-playcount=loop|number
specifies how many times a clip or playlist is repeated. Loop means infinite repeats. Read -ondone=rescan remarks. Examples:
mcvideo -href=video.mpg -playcount=5 -plays video.mpg 5 times
mcvideo -href=video.mpg -playcount=loop -plays video.mpg infinitely

-duration=numberOfSeconds
Program lifetime in seconds. It's max period the program is allowed to live regardless it played whole playlist or not.

-ondone=doNothing|close|rescan
A special option which specifies what program should do after finishing a playlist.
close: closes the program;
doNothing: does nothing, program window remains open, default value;
rescan: rescans a playlist source and plays the playlist again;
If you intend to change contence of playlist source during playback use -ondone=rescan. It rescans a playlist source and composes a new playlist. If you want continuous playback you can use -playcount=loop or -ondone=rescan. The difference is that -playcount=loop plays playlist infinitely but doesn't check playlist source changes while -ondone=rescan rescans the playlist source and composes a playlist again. Using -playcount=loop and -ondone=rescan together has no sense and is not allowed. You can still use e.g. -playcount=2 and -ondone=rescan together. The playlist will be played 2 times without rescan, then the playlist source will be rescaned, played 2 times, rescaned and played again ...

-window=[left],[top],[width],[height] or -window=fullscreen
Specifies location and size of the image window in pixels. As a default they are undefined and depend on system. All values are optional but commas must be used.
You can also specify -window=fullscreen to set window to fullscreen. If you want to get fullscreen window, -screen option must also be used to specify which system active screen to display on. Program reads specified screen bounds and sets window size to fill it. Fullscreen value doesn't work with default -screen=allscreans, you must specify active screen number.
If you want other programs to control window size and position do not use this option.

-screen=screen_number|allscreens
Specifies screen number which -window option refers to. If you specify screen number a window position given with -window option will be related to 0,0 point (left upper corner) of specified screen. Screen numbers are taken from these shown in Display properties, Settings. You should specify only active screen, otherwise the -window will be related to all active screens area. Default -screen=allscreens. If you want other programs to control window do not use this option

-borderstyle=none|sizable
shows or not window border. Default is normal sizable border. If the border is set to none, windows hasn't any controls, it's unmovable and unresizable. Use right-click and "Close" to close it.

-log=yes|no
shows or not log window. Default is no log.

Examples

mcvideo -href=http://mirrorblender.top-ix.org/peach/bigbuckbunny_movies/big_buck_bunny_480p_stereo.ogg
Show http://mirrorblender.top-ix.org/peach/bigbuckbunny_movies/big_buck_bunny_480p_stereo.ogg video clip

mcvideo -href=file:///c:/test/demo.avi -window=10,10,800,600 -borderstyle=none
Show borderless c:/test/demo.avi video at 10,10 and size 800x600. It hasn't any controls, it's unmovable and unresizable. Use right-click and "Close" to close it.

mcvideo -source=c:/video -window=fullscreen -screen=2 -borderstyle=none -ondone=rescan
Composes a playlist from video files in c:/video folder and plays it fullscreen on screen 2. After playing whole playlist it rescans a c:/video folder, composes a new playlist and plays it again. It repeats infinitely.

Revision history

Ver. 0.16 2009-01-24 borderless window size fix
Ver. 0.18 2009-02-17 local DVD play implemented
Ver. 0.20 2009-02-22 -playcount implemented
Ver. 0.22 2009-03-14 -ondone implemented
Ver. 0.24 2009-03-27 -duration implemented
Ver. 0.26 2009-11-14 -screen implemented, -window=fullscreen added
Ver. 0.28 2010-02-20 -ondone=rescan added