• Legacy /open: retained for existing Apple-platform integrations; supports a video URL and external subtitles.
• New /play: based on x-callback-url; supports a starting position and returns playback progress and status when playback exits.

The new /play method supports iPhone, iPad, Apple TV, Mac, Android Mobile, and Android TV.

New integrations should use /play. Existing Apple-platform /open integrations remain supported. Android Mobile and Android TV support only /play.

Platform Support

Feature Comparison

Legacy Method: /open

open-vidhub://x-callback-url/open

/open is retained for existing Apple-platform integrations and does not support Android.

Parameters

Basic Example

open-vidhub://x-callback-url/open?url=http%3A%2F%2Flocalhost%3A8080%2Fsample.mp4&on-success=some-app%3A%2F%2Fx-callback-url%2Fsuccess&on-failed=some-app%3A%2F%2Fx-callback-url%2Ffailed

Example with Subtitles

open-vidhub://x-callback-url/open?url=http%3A%2F%2Flocalhost%3A8080%2Fsample.mp4&sub=http%3A%2F%2Flocalhost%3A8080%2Fsample.srt&on-success=some-app%3A%2F%2Fx-callback-url%2Fsuccess&on-failed=some-app%3A%2F%2Fx-callback-url%2Ffailed

/open does not return the current position when the user exits and cannot distinguish completed playback from an early exit.

New Method: /play

open-vidhub://x-callback-url/play

/play uses the same address, parameters, and callback fields on iPhone, iPad, Apple TV, Mac, Android Mobile, and Android TV. It is designed for using VidHub as an external player. A calling app can provide its saved position, then receive the latest progress when playback exits. One call supports one video URL.

Request Parameters

url, sub, and every callback must be a complete URL with a scheme. A callback may not use the open-vidhub scheme.

Apple Swift Example

Use URLComponents and URLQueryItem to avoid manual encoding errors:

func playWithVidHub(
    mediaURL: URL,
    subtitleURL: URL? = nil,
    position: Double = 0,
    filename: String? = nil,
    requestID: String = UUID().uuidString
) {
    var components = URLComponents()
    components.scheme = "open-vidhub"
    components.host = "x-callback-url"
    components.path = "/play"

    var queryItems = [
        URLQueryItem(name: "url", value: mediaURL.absoluteString),
        URLQueryItem(name: "position", value: String(max(0, position))),
        URLQueryItem(name: "request-id", value: requestID),
        URLQueryItem(name: "x-source", value: "My App"),
        URLQueryItem(name: "x-success", value: "myapp://x-callback-url/success"),
        URLQueryItem(name: "x-error", value: "myapp://x-callback-url/error"),
        URLQueryItem(name: "x-cancel", value: "myapp://x-callback-url/cancel")
    ]

    if let filename, !filename.isEmpty {
        queryItems.append(URLQueryItem(name: "filename", value: filename))
    }
    if let subtitleURL {
        queryItems.append(URLQueryItem(name: "sub", value: subtitleURL.absoluteString))
    }
    components.queryItems = queryItems
    guard let vidHubURL = components.url else { return }

    #if os(macOS)
    NSWorkspace.shared.open(vidHubURL)
    #else
    UIApplication.shared.open(vidHubURL, options: [:], completionHandler: nil)
    #endif
}

Android Mobile / TV Kotlin Example

Android Mobile and Android TV use the same ACTION_VIEW intent:

import android.app.Activity
import android.content.ActivityNotFoundException
import android.content.Context
import android.content.Intent
import android.net.Uri
import java.util.UUID

fun playWithVidHub(
    context: Context,
    mediaUrl: Uri,
    subtitleUrl: Uri? = null,
    position: Double = 0.0,
    filename: String? = null,
    requestId: String = UUID.randomUUID().toString(),
) {
    val callbackBase = "myapp://x-callback-url"
    val vidHubUri = Uri.Builder()
        .scheme("open-vidhub")
        .authority("x-callback-url")
        .appendPath("play")
        .appendQueryParameter("url", mediaUrl.toString())
        .appendQueryParameter("position", position.coerceAtLeast(0.0).toString())
        .appendQueryParameter("request-id", requestId)
        .appendQueryParameter("x-source", "My App")
        .appendQueryParameter("x-success", "$callbackBase/success")
        .appendQueryParameter("x-error", "$callbackBase/error")
        .appendQueryParameter("x-cancel", "$callbackBase/cancel")
        .apply {
            filename?.takeIf { it.isNotBlank() }?.let {
                appendQueryParameter("filename", it)
            }
            subtitleUrl?.let { appendQueryParameter("sub", it.toString()) }
        }
        .build()

    val intent = Intent(Intent.ACTION_VIEW, vidHubUri).apply {
        if (context !is Activity) addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
    }
    try {
        context.startActivity(intent)
    } catch (_: ActivityNotFoundException) {
        // VidHub is not installed, or this version does not support the request.
    }
}

Example call:

open-vidhub://x-callback-url/play?url=https%3A%2F%2Fexample.com%2Fvideos%2Fmovie.m3u8&sub=https%3A%2F%2Fexample.com%2Fsubtitles%2Fmovie-en.srt&position=120&filename=Example%20Movie.mp4&request-id=movie-123&x-source=My%20App&x-success=myapp%3A%2F%2Fx-callback-url%2Fsuccess&x-error=myapp%3A%2F%2Fx-callback-url%2Ferror&x-cancel=myapp%3A%2F%2Fx-callback-url%2Fcancel

Use URLComponents, URLQueryItem, or Android Uri.Builder for percent encoding instead of assembling the complete URL manually.

Callback Rules

Each /play request triggers at most one terminal callback:

• Playback completes or the user exits the player: x-success.
• The request or playback fails: x-error.
• The user cancels before playback formally begins: x-cancel.

If a callback URL for that outcome is omitted, VidHub ends the flow without calling a different callback type.

x-success

Completed playback:

myapp://x-callback-url/success?lastPlayedUrl=https%3A%2F%2Fexample.com%2Fvideo.m3u8&position=599&duration=600&status=finished&request-id=movie-123

Early exit:

myapp://x-callback-url/success?lastPlayedUrl=https%3A%2F%2Fexample.com%2Fvideo.m3u8&position=38&duration=600&status=stopped&request-id=movie-123

• finished: mark the content played and clear or retain the resume position according to your app's rules.
• stopped: save position and pass it back in the next /play request.

x-error

myapp://x-callback-url/error?errorCode=200&errorMessage=Playback%20failed&failedUrl=https%3A%2F%2Fexample.com%2Fvideo.m3u8&request-id=movie-123

x-cancel

x-cancel applies only before playback formally starts and does not include progress. It returns request-id only when one was supplied:

myapp://x-callback-url/cancel?request-id=movie-123

Exiting after entering the player is not a cancellation; it calls x-success with status=stopped.

Receiving Callbacks

The calling app must register its own URL scheme. These examples use myapp://; replace it with your app's actual scheme.

Apple Platforms

UIKit with scenes:

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else { return }
    handleVidHubCallback(url)
}

SwiftUI:

.onOpenURL { url in
    handleVidHubCallback(url)
}

Android Mobile / TV

Register an intent filter for the callback activity:

<activity android:name=".VidHubCallbackActivity" android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="myapp" android:host="x-callback-url" />
    </intent-filter>
</activity>

Read the callback path and parameters from intent.data:

val callbackUri = intent?.data ?: return
when (callbackUri.path) {
    "/success" -> {
        val position = callbackUri.getQueryParameter("position")?.toDoubleOrNull()
        val duration = callbackUri.getQueryParameter("duration")?.toDoubleOrNull()
        val status = callbackUri.getQueryParameter("status")
        val requestId = callbackUri.getQueryParameter("request-id")
    }
    "/error" -> {
        val errorCode = callbackUri.getQueryParameter("errorCode")
        val errorMessage = callbackUri.getQueryParameter("errorMessage")
    }
    "/cancel" -> {
        val requestId = callbackUri.getQueryParameter("request-id")
    }
}

Android TV usually has no web browser, so use a callback scheme registered by the calling app rather than relying on an HTTPS web callback.

URL Encoding

Pass raw values to the platform URL builder and let it percent-encode them. Do not encode a value manually before handing it to URLQueryItem or Uri.Builder, or it may be encoded twice. Legacy /open retains its existing encoding behavior for compatibility.

Migrating from /open to /play

1. Change the path from /open to /play.
2. Rename on-success to x-success.
3. Rename on-failed to x-error.
4. Add x-cancel and request-id if needed.
5. Pass the locally saved playback position as position.
6. Read position, duration, and status from the callback.
7. Use the system URL builder for encoding.

Android Mobile and Android TV should use /play directly.

Notes

• Each request supports one video URL.
• /play uses the same fields on iPhone, iPad, Apple TV, Mac, Android Mobile, and Android TV.
• The VidHub device must be able to access the video and subtitle URLs.
• A media URL may use any network or local scheme supported by VidHub, but not open-vidhub.
• Callback URLs must use a scheme registered by the third-party app, not open-vidhub.
• If no app handles the callback scheme, VidHub does not retry indefinitely.
• A callback cannot be guaranteed if the app is force-quit, the system shuts down, or the process crashes.
• These callbacks synchronize playback progress for this request and do not depend on Trakt login or Trakt Scrobbling.

VidHub VIP works across Apple's platforms, including iPhone, iPad, Mac, and Apple TV. You can restore the same VIP entitlement on each platform.

If the device has multiple accounts, sign out of the other accounts, restart the device, and try Restore Purchases again.

Can a Mainland China Apple Account Restore a Purchase on Apple TV?

Yes. Because Apple TV does not provide a Mainland China App Store, use an account from another region to download VidHub first. Then switch the account in Settings to the Mainland China account that purchased VidHub. The App Store may disappear after the switch; this is expected. Open VidHub and choose Restore Purchases.

Restore on iPad, iPhone, or Mac

• If VidHub was purchased from the Mainland China store, download it from that store and choose Restore Purchases.
• If it was purchased from another region's store, download it from that region and choose Restore Purchases.

If restoration still fails, uninstall and reinstall VidHub, then try again using the Apple Account that made the purchase. You may also contact support with your purchase details. Apple's billing system normally prevents the same Apple Account from being charged twice for the same active subscription entitlement.

Open your television's picture settings, find Motion Compensation, Motion Smoothing, or the equivalent setting, and turn it off. If the problem continues, please contact the administrator.

Refund eligibility and the available steps are determined by Apple and may vary by country or region. For the latest process, always refer to Apple's official refund instructions.

The Simplest Web Method

1. Open reportaproblem.apple.com.
2. Sign in with the same Apple Account that made the purchase.
3. Choose I'd like to, then select Request a refund.
4. Select a reason, click Next, choose the app, subscription, or other item, and submit the request.

Your purchase history can include free apps, paid apps, in-app purchases, and subscriptions such as music, movies, and books. Explain the reason accurately. Common legitimate reasons include an accidental purchase, an app not providing an expected function, or an unrecognized charge.

Apple reviews each request. A request may be denied, particularly if there have been repeated refund requests or several orders are submitted at once. If you do not recognize a purchase, treat it as an account-security issue and contact Apple Support.

Request a Refund on iPhone or iPad

Apple emails a receipt for each purchase. The receipt may include a Report a Problem link that opens the same web refund process.

You can also find purchases and subscriptions on the device:

1. Open Settings.
2. Tap your name, then Media & Purchases.
3. Tap View Account and open Purchase History or Subscriptions.
4. Select the relevant purchase and follow the Report a Problem process.

Request a Refund on Mac

Open the Mac App Store, click your account, and choose Account Settings or View Information. From there, review your purchase history and subscriptions, then use Report a Problem for the relevant purchase.

Wait until the charge has completed before requesting a refund, and avoid submitting the same request repeatedly. Apple normally sends a decision after reviewing the request. Current status and instructions are available from Apple Support.

iCloud can synchronize file sources, the Media Library, watch history, playlists, favorites, media servers, and other information across multiple devices.

• Sign in with the same iCloud account on every device.
• Enable iCloud Drive on every device.
• In VidHub, open Settings > Sync > iCloud Sync.
• Make sure your iCloud account has enough available storage.
• Run the latest system and iCloud version on every device.
• If iCloud storage is full or insufficient, imported files may be missing or videos may fail to play correctly.

• Hide Spoilers: When enabled, episode descriptions are hidden on series detail pages. Disable it to show descriptions.
• Media Sort Order: Sets the default order used when browsing media.
• File Sort Order: Sets the default order used when browsing files.
• Appearance: Choose a dark or light interface, or follow the system setting automatically.
• Online Metadata Language: Choose the language for online movie and TV metadata, or follow the system language automatically.
• Allow Cellular Data: Allow or prevent downloads over cellular data.
• Concurrent Downloads: Set how many videos may download at the same time.
• Show Floating Window: Show or hide the small download-status window.
• Pause During Playback: Pause downloads automatically while a video is playing.

Resources

• Media Library: Shows the number of titles of each type currently in your library.
• Rescan Files: Rescans all video files in every file source and synchronizes changes with the Media Library.
• Refresh Online Metadata: Retrieves movie and TV information from TMDB again. Run this after changing the Online Metadata Language to download data in the new language.
• File Sources: Select a source to enable it; clear the checkmark to disable it.

Downloads

View and delete videos downloaded to local storage.

Sync

iCloud Sync: Allow Media Library details to be synchronized through iCloud.

Playback

• Forward/Back Interval: Set how many seconds each seek-forward or seek-back action moves.
• When Opening Alibaba/Baidu Cloud Videos: Choose original quality or the highest-resolution video stream.
• Continuous Playback: Automatically play the next episode when enabled.
• Background Playback: Continue playing when the app moves to the background.
• Always Remember Playback Speed: Reuse the speed selected before you last exited playback.
• Hardware Acceleration: Use hardware acceleration to improve performance.
• Cache to Disk: Enable or disable disk caching.

Player Interface

• Automatically hide the playback controls after the selected interval.
• Show total duration or remaining time to the right of the progress bar.
• Choose the speed used for long-press accelerated playback.
• Enable or disable double-tap seek forward/back.
• Show or hide screenshot and screen-recording buttons.
• Enable or disable landscape display by default.
• Enable or disable the playback-control background shadow.

Subtitles

• Choose the rule used to load external subtitle files automatically.
• Enable or disable automatic loading of embedded subtitles.
• Choose the preferred embedded-subtitle language, when that language is available.
• Choose the language used for online subtitle searches.

Screenshots and Recording

• Choose the screenshot image format.
• Choose the GIF frame rate.
• Choose the GIF resolution.

Video playback operation interface: left 1.Screen Lock: The button with a lock icon on the left side is used to lock the screen. When the button is white and open, you can interact with the current interface. When it is closed and green, no "operations" can be performed on the current interface, and you can only click the lock button again to unlock it. Note: When the screen is locked, all other icons will be hidden. Clicking again will show them. 2.Video Rotation: The green state represents the current landscape mode. If clicked and turned white, it becomes portrait mode. 3.Episode Selection: The icon with three horizontal bars at the bottom left will show all movie files in the same folder when clicked. If there is only one movie file in the folder, this button will not be displayed. 4.Resolution: The Original button at the bottom is used to set the resolution. Clicking on it will expand the available resolution options. Note: If the video is imported from WebDAV/Alist, the resolution will not be displayed. If there is only one file in the folder and it is imported from WebDAV/Alist, neither the episode selection nor the resolution will be displayed. 1.Snapshot: The icon in the middle on the right side, represented by a camera-style image, is used for taking snapshots. Clicking on it captures the current frame of the video. (This function can be used during both playback and pause.) 2.GIF: Clicking on the GIF icon starts recording a GIF image. Clicking again generates the GIF and saves it to the photo album. To close the GIF recording window, simply click anywhere blank on the screen. (If the video is paused while using the GIF function, it will automatically resume playing.) 3.Fit to Screen: Clicking on this option adjusts the video to fit the screen size.

When a video is incorrectly scraped or classified as "Other," use this feature to change the corresponding file to the correct movie/TV show.

Accessing the Feature

For individual movies and videos in the "Other" category: Long press on (right-click on macOS) the video poster in the media library, then select the "Edit Information" option. Alternatively, go to the movie details page and click on the three dots in the top right corner, then click on "Edit Information." Movie Collection/TV Series Go to the movie details page, select a single episode, click on the three dots in the top right corner, and then click on "Edit Information."

Function Usage Introduction

1.Input Box: The input box in the edit information interface allows you to search for a movie name. Select the corresponding movie from the search results, and the information of the movie being edited will be replaced with the selected movie. 2.Change to Movie: For movies in other categories, after finding the correct movie information through search, apply it to move the movie to the movie category. 3.Change to TV Show: For movies in other categories, after finding the correct TV show information through search, apply it to move the movie to the TV show category. 4.Use Original File Data: For movies in the movie/TV show category, selecting to use the original file data will move the movie to the other category. 3.1. TV Series: If you want to edit a TV series, first go to the movie details page, select any episode from a specific season, click on the three dots in the top right corner, and then click on "Edit Information." After searching and selecting the TV series you want to modify, make the necessary changes. Wait for a moment, and the information of all other episodes in the same season will be automatically updated.

After entering the file source, long-press the individual folder/file and click on "Rename". A rename popup will appear. Enter the new name and click "Save". The folder/file will then be renamed with the new name.

Batch Rename

After entering the file source, click on the three dots in the upper right corner of the file source, then click on "Edit". Next, click on the three dots in the lower right corner to enable multiple selection of files/folders for renaming. Batch Renaming of Previously Selected Folders/Files

Add Text:

This refers to the renaming method where new text is added to the original file name. If the input is placed before the name, the content will be displayed before the original name. If the input is placed after the name, the content will be displayed after the original name. For example: Adding "123" before the name will result in all file names being prefixed with "123".

Replace Text

This refers to the renaming method where certain text in the original file name is replaced with new text.

Enter the text "A" to be replaced with in the "Search" input box, and enter the replacement text "B" in the "Replace with" input box. The text "A" in the file names will all be replaced with text "B".

For example, if you input "Doctor" in the search box and "123" in the replace with box, after renaming, all occurrences of "Doctor" in the file names will be replaced with "123".

Formatting

Formatting refers to the renaming method where a numerical index is added uniformly to the original file names. Custom Format: This allows for the reconfiguration of the file names. Starting Index: The index number can represent the season or episode number of a TV show. After/Before Name: The index number can be added after or before the custom format. After renaming, the file names will become "{custom format}{index number}" or "{index number}{custom format}". For example, if the custom format is set as "Test" and you choose to place the index number after the name, the file will be renamed as "Test01". If placed before, it will be "01Test". Fixed Length: Specifies the number of digits for displaying the index number. For example, for an index number of "1", if the fixed length is set to 1, it will be displayed as "1". If the fixed length is 2, it will be displayed as "01". If the fixed length is 3, it will be displayed as "001". As shown in the example below, if the custom format is set as "Fast and Furious S01E" and the index is placed after the name, and the starting index is set as "5" with a length of 2 digits ("5" displayed as "05"), the selected files will be renamed as "Fast and Furious S01E05" and "Fast and Furious S01E06".

Regular expressions

Advanced replacement functionality refers to the method of using regular expressions to replace certain text with new text Enter the text you want to replace in the regular expression box, for example, "\d{3}", which represents any three digits. In the replacement input box, enter the text B you want to replace with. Any three digits in the original file will be replaced with the text B Note: Please search for how to use regular expressions.

If VidHub matches a movie or show incorrectly, change the file name or edit the media information manually:

1. Modify file names
2. Edit media information manually

Correct Movie Naming

Start the file name with the movie's full title. English and non-English titles are both supported. For example:

1. The Wandering Earth.1080p.x264.mp4
2. Ghosted.1080p.x264.mp4
3. Ghosted.2023.1080p.x264.mp4

If multiple movies share the same title, include the release year in the file name:

1. The.Wandering.Earth.2019.1080p.x264.mp4

Correct TV Series Naming (Including Variety Shows and Animation)

Each episode must start with the series title, followed by season and episode information. English and non-English titles are both supported. S01 means Season 1, S02 means Season 2, E01 means Episode 1, and E02 means Episode 2. For example:

1. Nirvana.in.Fire.S01E01.1080p.AMZN.WEB.DL.mkv
   Meaning: Nirvana in Fire, Season 1, Episode 1

2. Shameless.S03E02.1080p.AMZN.WEB.DL.mkv
   Meaning: Shameless, Season 3, Episode 2

If multiple series share the same title, include the year of the series premiere:

3. Shameless.2011.S02E02.1080p.AMZN.WEB.DL.mkv

Extras and Specials

For extras and special episodes, start with the series title, use Season 00, and specify the episode number. For example:

1. Nirvana.in.Fire.S00E01.SneakPeek.1080p.AMZN.mkv
   Meaning: Nirvana in Fire, Special, Episode 1

Every long-press action below applies to the mobile version. On desktop, use a right-click instead.

Single-Item Actions

Rescan Files (File Source or Folder)

Long-press an added file source, or open a source and long-press a folder, to rescan all video files beneath it. New, deleted, or renamed files are automatically synchronized with the Media Library. You can also open Folder A, click the three-dot button in the upper-right corner, and choose Rescan Files.

Rename

When you rename a file or folder from VidHub, the original item in its storage location is renamed as well. Media information is scraped again using the new file name. View the video file naming conventions.

Download (File)

Long-press a file and choose Download to save the video locally. Downloaded files are available under Settings > Downloads.

Delete

Deleting a file or folder in a VidHub file source permanently deletes the original item from its storage location. The corresponding title is also removed from the Media Library. Use this action carefully.

Move to Recycle Bin (Alibaba Cloud Drive)

Long-press a file or folder in an Alibaba Cloud Drive source and choose to move it to the recycle bin. You can view and restore the item from the recycle bin in Alibaba Cloud Drive.

Multi-Item Actions

1. Open a file source and enter a folder containing your videos. Click the three-dot button in the upper-right corner and choose Edit. You can also choose Rescan Files (Current Directory) here.
2. After you click Edit, the page enters editing mode.
3. Select one or more files, then click the three-dot button in the lower-right corner to perform an action on the selection. Click Done in the upper-right corner when finished.

1. If you stop watching before a video ends, it appears in Continue Watching with its current progress. Click the white Play button to resume.
2. A completed movie moves to Watched.
3. For a TV series, the next episode appears in Continue Watching after the current episode finishes. If the series has multiple seasons, finishing one season shows the first episode of the next season. The series moves to Watched after all seasons are complete.
4. Long-press a video in Continue Watching and choose Mark as Watched.
5. Three options are available: - Current Episode: only the selected episode is added to Watched. - Entire Season: every episode in the selected season is added to Watched. For example, after Season 1 is marked, Season 2 remains in Continue Watching. - Entire Series: every season and episode is added to Watched, and the series no longer appears in Continue Watching.

Create a Playlist

1. On the home page, click the three-dot button in the upper-right corner and choose Edit Media Library.
2. Find Playlists at the bottom and enable it. It is hidden by default.
3. In the Media Library, find Playlists and click View All.
4. On the All Playlists page, click New Playlist in the upper-right corner.
5. Name the new playlist and click Save.
6. The new playlist is now shown on the Playlists page.

Delete a Playlist

Open the playlist, click the three-dot button in the upper-right corner, and choose Delete Playlist.

Deleting a playlist removes only the playlist. Its videos remain in the Media Library.

Add Videos to a Playlist

Long-press a movie poster on the Media Library page and choose Add to Playlist.

Adding a TV series adds every episode in that series to the playlist.

Add to Favorites

Long-press a poster and choose Add to Favorites. The title also appears in Favorites. Long-press it again and choose Remove from Favorites to remove it.

Favorites must be enabled to appear. Configure it under Media Library > three-dot button > Edit Media Library.

Mark as Watched

Titles marked as watched appear in Watched; canceling the mark removes them.

If a title in Continue Watching is marked as watched and you later cancel that mark, its previous playback history is not restored.

Media Library Status

While files are being scanned, scroll to the bottom to view the current status. After scanning completes, the bottom of the page shows the number of movies, TV series, and other videos in the Media Library.

Media Library

Media Library: All the displayed movies are sourced from the video files in the "File Sources" section. When you add a new folder as a file source, VidHub will automatically search, scrape, and add all the video files in that source to the media library. Definition: Scraping refers to searching online for movie/show information and posters based on the video file names, and then adding the search results to the media library after organizing them. Clicking on the three-dot icon in the top right corner will present options: "Rescan Files" and "Edit Media Library". 1.2: "Rescan Files" does exactly as its name implies. It rescans all video files in the file sources, identifies any changes, and synchronizes them with the media library. It is necessary to rescan files when there are changes (additions/deletions/renaming) in the videos within the file sources. (For users with a large number of movies in their file sources, be cautious when using this feature as it performs a full scan of all file sources, which may take a considerable amount of time. If you know the precise location of the newly added/deleted/renamed video files, it is recommended to scan only that specific location, which will be explained later.) 1.3: "Edit Media Library" allows you to "show/hide/sort" categories within the media library. For example, you can choose to hide the movie category, so it will no longer be visible. You can also rearrange the order of the categories, such as moving TV shows to the second position and movies to the first position. 1.4: Clicking on "View All" shows all the movies within the current category.

File Sources

File Sources can be understood as a repository, a place to manage movie resources. It supports adding, deleting, disabling, renaming, and rescanning files. Definition: It is a repository for storing movies. Long-press on any added file source. 1.2: Delete: Delete the file source. All related movies in the media library will be automatically removed after deletion. 1.3: Disable/Enable: Clicking on "Disable" will hide all related movies in the media library. Clicking on "Enable" will display all related movies in the media library again. 1.4: Rename: As the name suggests, modify the name of the "File Source". 1.5: Rescan Files: Perform a separate scan for the files in this file source. It will not affect other file sources. 1.6: The naming convention in the top-left corner of the File Sources section is where you can specify the naming format for movies/shows. Only when you follow the convention and name your movies/shows accordingly, will VidHub automatically scan and gather the corresponding movie/show information, and organize them in the media library. 1.7: Edit: By clicking on the three-dot icon in the top-right corner and selecting "Edit," you can choose multiple file sources and delete them. 1.8: Add/Modify File Source: By clicking on the three-dot icon in the top-right corner, the option to "Add/Modify File Source" will appear. 1.9: Click on "Add/Modify File Source" to access the current page (which stores added local/network/cloud sources). 2.0: Click on "Add Storage" for redirection. 2.1: Network Share: Input the "Server Address" (URL), Port, Username, Password, Path (optional) (from shared by others or if you have your own storage URL videos, assuming VidHub supports it; currently supports WebDav and SMB protocols). 2.2: Cloud Drive: Import movies from the cloud drive to VidHub for organization and playback. For details, please refer to the beginner's guide. Currently supports Alibaba Cloud Drive/Baidu Cloud Drive/Dropbox/OneDrive/Google Drive/Premiumize, etc. 2.3: Open Local Videos: Upon clicking this option, an iCloud Drive pop-up will appear. If the video resources are stored in iCloud, you can directly navigate to the corresponding folder and play the selected video. If the videos are not in iCloud, click the top-left corner to return to browsing. In the Location category, find and click on "My iPhone." From there, navigate to the folder where the video resources are stored and click to enter. You can then directly play the video files. Note: Opening local videos will directly play the selected video file. 2.4: Add Local Directory: Select a local folder as a file source. Upon clicking, an iCloud Drive pop-up will appear. If the resources are located in iCloud, you can directly navigate to the corresponding folder. Click "Open" in the top-right corner to add this directory as a file source. If the resources are not in iCloud, click on the top-left corner to return to browsing. Look for "My iPhone" in the Location category and click on it. Browse through the files on your iPhone to find the folder where the video resources are stored. Once inside the folder, click "Open" in the top-right corner to add this directory as a file source. Note: The selected local directory will be added as a file source, and all video files within that directory will be scraped and imported into the media library. If your local videos are in the Photo app, you need to long-press the video, click on "Share," and then choose "Save to Files." Afterwards, you can use the Open Local Video/Open Local Directory features in VidHub to play or import the video into the media library.

Media Servers

Media Servers: VidHub supports adding Plex/Emby/Jellyfin media servers. By providing the server address, username, password, and other required information, you can log in and add a media server. Once added successfully, you can access and stream content from the media server by clicking on it. (Media servers can be self-hosted or publicly accessible servers set up by others.)

VidHub is a versatile video player for iPhone, iPad, Apple TV, and Mac. When you need a feature-rich media player to manage, organize, and play various types of videos, VidHub will meet your needs. VidHub supports managing video files on Aliyun Disk/Baidu Cloud/Google Drive/Dropbox/One Drive, supports samba(smb)/webdav protocols, supports NAS network storage such as Synology, supports local files, and supports Plex/Emby/Jellyfin media servers. VidHub can automatically scrape movie/show covers and other information based on video file names, automatically categorize and organize your video resources, and support one-click global search. It also has powerful and user-friendly playback features, including playback speed adjustment, subtitles, screenshots, HDR, Dolby Vision, and more.

What media formats are supported

VidHub can support a wide range of video playback files video：mkv、mp4、.mov、.rmvb、avi、webm、wmv ETC... Subtitles: VidHub supports built-in subtitles in videos and can mount a variety of external subtitle formats, such as SRT, SSA, ASS, SUB.

Best Compatible Devices for VidHub

Mac Device requires macOS 10.15 or later. iPhone Device requires iOS 14.1 or later. iPad Device requires iPadOS 14.1 or later. iPod touch Device requires iOS 14.1 or later. Apple Vision Device requires VisionOS 1.0 or later. Apple TV Device requires Apple tvOS 14.0 or later.

What else can VidHub do for me?

VidHub offers excellent file management capabilities and supports interface display of video playlists. Users can quickly find the desired media files by categorizing them based on types, dates, ratings, and more. But it doesn't stop there. VidHub has many powerful features waiting for you to explore. We are continuously striving to improve the user experience, and we greatly appreciate your valuable suggestions and feedback. Please feel free to share your thoughts with us through the community, App Store, or email. Thank you.