VideoLAN Wiki - User contributions [en]

VLCKit

2010-10-26T14:51:53Z

Myrrhman: /* Sample code */

=== Build the framework ===

* open <code>./vlc/projects/macosx/framework/VLCKit.xcodeproj</code>
* make sure the VLCKit target is selected
* rightclick on target and build

this should autatically build vlc itself at the same time in projects/macosx/framework/build/vlc_build_dir
== Basic usage in your application ==
The code should speak by itself
// Set up a videoView by hand. You can also do that in the nib file
videoView = [[VLCVideoView alloc] initWithFrame:[[window contentView] bounds]];
[[window contentView] addSubview:videoView];
[videoView setAutoresizingMask: NSViewHeightSizable|NSViewWidthSizable];

// Init the player object
player = [[VLCMediaPlayer alloc] initWithVideoView:videoView];

[player setMedia:[VLCMedia mediaWithPath:@"/to/my/movie"]];
[player play];

== Sample code ==
You should be able to find sample code in:
* <code> ./vlc/projects/macosx/framework/Examples </code>: This is the folder that contains the VLC.framework basics usage.

* <code> ./vlc/projects/macosx/vlc_app </code>: This is the VLC application that uses the framework intensivly, this is much more advanced.

For more Mac-related stuff feel free to check [http://www.mac-how.net Mac-How]

MacOS

2010-08-29T07:51:19Z

Myrrhman: /* Need Help? */

<div style="width:820px;border: 1px solid #ffc9c9>
{{vlc_MacOS_toc}}
<div style="padding: .4em .9em .9em">

==Graphical Interface==
Many people who want to use [[VLC media player]] on Mac OS X will be intending to use the standard graphical interface that is provided by vlc. The standard interface consists of the eight menus in the menu bar and the 'VLC - Controller' window that opens up by default. This section outlines what vlc can do for you (at V0.8.6a current active is V{{VLC:latest version}}) and will be completed as I check the use of menu options.

The eight menu bar options are listed below along with the main interesting capabilities under each menu item:

* [[vlc_MacOS_VLC|VLC]] which allows you to check for an updated application, to access the preferences and to add an interface.
* [[vlc_MacOS_File|File]] which allows you to open a media file or an associated file such as subtitles. It also has a wizard to allow the streaming of video or the capturing of a streamed video to a file.
* [[vlc_MacOS_Edit|Edit]] which does nothing vlc specific.
* [[vlc_MacOS_Playback|Playback]] allows you do do all the things you might expect from a videoplayer, some of these features are duplicated graphically in the 'Controller' window.
* [[vlc_MacOS_Audio|Audio]] allows you to control the audio level as well as the output device and the audio track to use from the input.
* [[vlc_MacOS_Video|Video]] allows you to control the video display on your screen as well as which device to display on and which video source to show in that display.
* [[vlc_MacOS_Window|Window]] allows you to display seven helper windows that will display information about vlcs activity and control more detail of that activity.
* [[vlc_MacOS_Help|Help]] gives access to the help that came with the installation, the help info on the VideoLAN site and access to interaction mechanisms with the vlc developers.

In general, for many users, they find that they can get what they want from vlc 'straight out of the box' and have very little need of the menu options until they have been using vlc for a while and now want to try something 'more fancy'.

==Keyboard Shortcuts==
You can find most of the keyboard shortcuts by taking a look at the menus. Additional hotkeys are defined in the section "Hotkeys" of your VLC preferences.

Some handy key combo's are:

* You can use the spacebar to start/pause the video.
* When playing video, holding down the Apple key and pressing the F key enters and exits fullscreen. When in fullscreen you can also use the escape key to exit the fullscreen state.
* When playing video, holding the Apple and Shift keys and pressing the left/right arrow keys, jumps the video backward/forward about a minute.
* When playing video, holding the Apple and Ctrl keys and pressing the left/right arrow keys, jumps the video backward/forward about ten seconds.
* When you are watching a DVD and the video window is the front-most window you can use the arrow keys and the enter key to navigate the DVD menus.

* F - Decrease Audio Delay in milliseconds
* G - Increase Audio Delay in milliseconds
* H - Decrease Subtitle Delay
* J - Increase Subtitle Delay

==Latest developments==

===Streaming Wizard===
A streaming wizard is available since the VLC media player 0.8.4 release. This is available under the "File" menu.

=== Command line ===

You can run VLC on Mac OS X using a terminal application (for example Terminal.app in /Applications/Utilities) with the following command:
/Applications/VLC.app/Contents/MacOS/VLC [your options, "--intf=rc" for example]
On most Bourne-like shells, you can set an alias to just vlc with the following command:
alias vlc='/Applications/VLC.app/Contents/MacOS/VLC'
It can be helpful to add this command to your shell setup file.

This option can also be activated from the "VLC" menu.

==== Command line examples ====
Following command does this: Transform video-filter (flip vertically), transcode (save) to file.

/Applications/VLC.app/Contents/MacOS/VLC -I rc --vout-filter=transform --transform-type=vflip /Movie.mov --sout='#transcode{vcodec=h264,vb=800,scale=1,acodec=mp4a,ab=128,channels=2,samplerate=44100}:std{access=file,mux=ts,dst=/output.mp4}'</nowiki>

-I rc is so that it doesnt open the GUI, but stays on the command line version
--vout-filter defines the filter to use
--transform-type defines the attributes of the transform filter
/Movie.mov is the file to convert
--sout= is the stream output chain
/output.mp4 is the output file name

=== No Dock ===
Note that you can replace the "VLC" at the end of the path with "clivlc" to suppress the launch of any Mac-like interface.
VLC won't even appear in the Dock then.

When [[transcoding]], clivlc should be used if running VLC from the command line crashes with a Bus error.

You can also specify the option -I rc on the "VLC" executable.

==Need Help?==
View the [[FAQ on MacOSX only issues]] or the [[Common Problems]] pages or [http://mackeeper.zeobit.com/how-to-make-your-mac-faster osx safe mode]
[http://www.mac-how.net Mac-How]
[[Category:Operating systems]]

</div>
</div>

MacOS

2010-08-19T12:25:59Z

Myrrhman: /* Need Help? */

<div style="width:820px;border: 1px solid #ffc9c9>
{{vlc_MacOS_toc}}
<div style="padding: .4em .9em .9em">

==Graphical Interface==
Many people who want to use [[VLC media player]] on Mac OS X will be intending to use the standard graphical interface that is provided by vlc. The standard interface consists of the eight menus in the menu bar and the 'VLC - Controller' window that opens up by default. This section outlines what vlc can do for you (at V0.8.6a current active is V{{VLC:latest version}}) and will be completed as I check the use of menu options.

The eight menu bar options are listed below along with the main interesting capabilities under each menu item:

* [[vlc_MacOS_VLC|VLC]] which allows you to check for an updated application, to access the preferences and to add an interface.
* [[vlc_MacOS_File|File]] which allows you to open a media file or an associated file such as subtitles. It also has a wizard to allow the streaming of video or the capturing of a streamed video to a file.
* [[vlc_MacOS_Edit|Edit]] which does nothing vlc specific.
* [[vlc_MacOS_Playback|Playback]] allows you do do all the things you might expect from a videoplayer, some of these features are duplicated graphically in the 'Controller' window.
* [[vlc_MacOS_Audio|Audio]] allows you to control the audio level as well as the output device and the audio track to use from the input.
* [[vlc_MacOS_Video|Video]] allows you to control the video display on your screen as well as which device to display on and which video source to show in that display.
* [[vlc_MacOS_Window|Window]] allows you to display seven helper windows that will display information about vlcs activity and control more detail of that activity.
* [[vlc_MacOS_Help|Help]] gives access to the help that came with the installation, the help info on the VideoLAN site and access to interaction mechanisms with the vlc developers.

In general, for many users, they find that they can get what they want from vlc 'straight out of the box' and have very little need of the menu options until they have been using vlc for a while and now want to try something 'more fancy'.

==Keyboard Shortcuts==
You can find most of the keyboard shortcuts by taking a look at the menus. Additional hotkeys are defined in the section "Hotkeys" of your VLC preferences.

Some handy key combo's are:

* You can use the spacebar to start/pause the video.
* When playing video, holding down the Apple key and pressing the F key enters and exits fullscreen. When in fullscreen you can also use the escape key to exit the fullscreen state.
* When playing video, holding the Apple and Shift keys and pressing the left/right arrow keys, jumps the video backward/forward about a minute.
* When playing video, holding the Apple and Ctrl keys and pressing the left/right arrow keys, jumps the video backward/forward about ten seconds.
* When you are watching a DVD and the video window is the front-most window you can use the arrow keys and the enter key to navigate the DVD menus.

* F - Decrease Audio Delay in milliseconds
* G - Increase Audio Delay in milliseconds
* H - Decrease Subtitle Delay
* J - Increase Subtitle Delay

==Latest developments==

===Streaming Wizard===
A streaming wizard is available since the VLC media player 0.8.4 release. This is available under the "File" menu.

=== Command line ===

You can run VLC on Mac OS X using a terminal application (for example Terminal.app in /Applications/Utilities) with the following command:
/Applications/VLC.app/Contents/MacOS/VLC [your options, "--intf=rc" for example]
On most Bourne-like shells, you can set an alias to just vlc with the following command:
alias vlc='/Applications/VLC.app/Contents/MacOS/VLC'
It can be helpful to add this command to your shell setup file.

This option can also be activated from the "VLC" menu.

==== Command line examples ====
Following command does this: Transform video-filter (flip vertically), transcode (save) to file.

/Applications/VLC.app/Contents/MacOS/VLC -I rc --vout-filter=transform --transform-type=vflip /Movie.mov --sout='#transcode{vcodec=h264,vb=800,scale=1,acodec=mp4a,ab=128,channels=2,samplerate=44100}:std{access=file,mux=ts,dst=/output.mp4}'</nowiki>

-I rc is so that it doesnt open the GUI, but stays on the command line version
--vout-filter defines the filter to use
--transform-type defines the attributes of the transform filter
/Movie.mov is the file to convert
--sout= is the stream output chain
/output.mp4 is the output file name

=== No Dock ===
Note that you can replace the "VLC" at the end of the path with "clivlc" to suppress the launch of any Mac-like interface.
VLC won't even appear in the Dock then.

When [[transcoding]], clivlc should be used if running VLC from the command line crashes with a Bus error.

You can also specify the option -I rc on the "VLC" executable.

==Need Help?==
View the [[FAQ on MacOSX only issues]] or the [[Common Problems]] pages or [http://mackeeper.zeobit.com/how-to-make-your-mac-faster osx safe mode]
[http://www.mac-how.net More Info]
[[Category:Operating systems]]

</div>
</div>