Documentation:IOS

From VideoLAN Wiki
Jump to navigation Jump to search

Preliminary Note

VLC for iOS is different from what you can do with VLC on desktops. In some regards, you can do more, in others, you can do less. VLC for iOS does only do media playback. Active streaming or file / stream to file conversations are not supported for usability and performance reasons. This walk-through does only include screenshots of the iPhone interface for size reasons. However, all features are also available on iPad with virtually the same appearance.

Media Synchronization

There are multiple ways to synchronize media files to VLC for iOS. Those may be extended in future releases. Streaming without saving files using the limited space available on iOS devices is also supported. See below.

iTunes File Sharing

Using iTunes, you can add and delete files to VLC for iOS. Apple provides excellent documentation for this.

WiFi Upload

If your iOS device and your Mac or PC is on the same local WiFi network, you can use WiFi Upload to add files to VLC for iOS' library.

Within VLC for iOS, click the cone button:

Location of the Cone menu in VLC for iOS

This will expose the sidebar menu. Locate the WiFi Upload menu item. Notice the empty circle indicating the server's off-state and the description "Inactive Server". Note that in earlier versions of VLC for iOS, you'll see a toggle button.

VLC for iOS' sidebar menu with WiFi Upload item

Click the item or switch the toggle. A network address will appear in the item:

VLC for iOS sidebar' menu with WiFi Upload switched on

Enter the network address to your web browser on your Mac or PC on the same local network:

Entering the network address in the webbrowser

VLC for iOS' WiFi Uploading page will appear. You can drag any file stored on your Mac or PC to this window for immediate upload to your iOS device. Additionally, you can press the "Upload files" button in the top-right to expose a file selector panel in case your files are not reachable by drag and drop. VLC for iOS' WiFi Uploader supports multiple uploads at the same time and will indicate through a progress when upload is complete. Because it's VLC after all, you can start playback of most files on your iOS device as soon as they appear so you don't need to wait until the upload is finished. VLC for iOS WiFi Upload page

Dropbox

VLC for iOS natively supports Dropbox. Open the menu as described above, choose Dropbox. For the first time, a login button will appear. When clicking, you'll be redirected to the Dropbox app for login or to the web if you don't have Dropbox installed. VLC for iOS will receive read and write access to your entire Dropbox after login. However, VLC for iOS does not support any write actions (i.e. you cannot upload files from VLC for iOS to your Dropbox either), so don't worry about your file integrity.

Downloads from the Web

The sidebar menu also includes an item called Downloads (or in earlier versions Download from Web Server). When selected, it will show the download queue and progress of downloads triggered through the network integration (see below) and exposes a field to enter a URL to directly download media from somewhere. Both HTTP and FTP are supported (earlier versions support HTTP only)

Downloads

Network Integration

In addition to the media synchronization options described above, VLC for iOS provides a variety of options to interact with networking sources. Additionally, third party websites and apps may include links to open streams directly in VLC for iOS.

Open Network Stream

Clicking on this item in the sidebar menu reveals a URL field to open a network streams. HTTP, FTP, MMS, MMSH, RTSP, UDP, and RTP streams are supported. Additionally, this view includes a list of your last 15 streams and an option to disable keeping the history.

Local Network

Introduced in VLC for iOS 2.2, Local Network discovers and lists servers found on your local network. At present, this includes UPNP media servers and FTP servers announced via Bonjour / Rendezvous. Further options will be made available in future releases. Depending on the server capability, you can both stream and/or download the stored contents.

Local Network servers

Clicking on "Connect To Server" exposes the ability to connect to FTP servers not included in the list.

Playback

The controller panel provides access to basic playback controls, a video filter panel, audio and subtitles track selection as well as playback speed. The time slider a the top of the playback screen matches the default media player behavior by allowing you to seek at the pace you want. Next to it, you will find a 2-mode time counter and a button to control aspect ratio and cropping. VLC for iOS will remember the last playback position for media stored on your iOS device.

VLC for iOS Playback view

Subtitles and multiple audio tracks

If your media includes subtitles or multiple audio track, buttons will appear in the playback controller to switch streams. VLC for iOS will remember the last chosen audio or subtitles track for future playback. If your media does not include subtitles, but you'd like to show some, give them a similar name to the media item, synchronize them and VLC for iOS will discover them automatically.

Video Filters

Like VLC media player on desktops, VLC for iOS allows you to modify the video’s colors in real time. Brightness will adapt your device’s physical luminance unless you play your media on an external screen, where it will fallback on a software mode.

VLC for iOS Video Filters.png

Playback Speed

Clicking the clock button to the left of the playback controller reveals a slider with a logarithmic scale to adapt the playback speed to your needs.

VLC for iOS playback speed.png

Media Library

Your media collection. It offers basic information about each file, such as length, resolution, or file size. Your last playback position is visualized through an orange triangle at the bottom of the snapshot, unless it’s new or fully played.

VLC for iOS media library.png

Smart handling of music albums and TV shows

VLC for iOS 2.1 added smart handling of music albums and TV shows. Based upon meta tags and pattern matched file names, VLC for iOS will automatically detect TV shows and music albums. Switching the library mode in the sidebar menu will reveal dynamic collections for either category. "All Files" switches back to the default mode listing all files available on your iOS device within the VLC context.

VLC for iOS smart library.png

Customization and Settings