Adding Video


S3D Player has a Catalog button. It opens the Media Manager, a window for quick access to 3D videos and pictures. You select a source from the list, scroll through the cards and start a video with a single click. A source can be a folder on your computer, a YouTube channel or your own password-protected server. Sources are described in a plain text configuration file, and you can add as many as you need without any programming.

media manager

Connection methods

The player supports four types of video sources. Choose the one that fits your task. They can be combined: one catalog may contain several local folders, channels and servers.
Method Where the videos are What you need Saving to disk
Local folder On your computer Only the folder path Not needed, the files are already yours
YouTube channel On YouTube A link to the channel Allowed
Your own server On your web hosting Hosting with PHP, our code package If the server allows it
Server + Cloudflare R2 In Cloudflare R2 cloud storage Hosting with PHP, a Cloudflare account, our code package If the server allows it

Catalog configuration

All media sources are described in two text files located in the player folder plugins\catalog\. You can open them directly from the Media Manager window with the Base and User buttons. Once a file is saved, the window picks up the changes automatically.

catalog-base.txt: a list of sources that demonstrates the player. This file is replaced by player updates from time to time, so do not put your own changes here: they will be lost on the next update.
catalog-user.txt: your own list. Updates never modify it.

In the source selection list, sources appear in the same order as in the files: first everything from catalog-base.txt, then everything from catalog-user.txt. If your file contains a section with the same name as one in the base file, your settings replace the base ones.

File format
Each source starts with a name in square brackets, followed by lines in the form key = value. Anything after the # sign is a comment. General settings are written at the top of the file, before the first section:
# general settings
quality  = 1080      # 720 / 1080 / 2160
thumb    = max       # preview: mq / 720 / max
save_dir = D:\Video\Saved
cookies  = firefox   # YouTube sign in, see the YouTube section

# source
[My 3D videos]
path      = D:\Video\3D
recursive = 1
folder

Method 1: a folder on your computer

The simplest method. The player scans the folder and shows all videos as cards with previews. Previews are taken from a frame of the video itself; for 3D videos the left view is used.

Step 1. Open catalog-user.txt
In the Media Manager window, click the User button.

Step 2. Add a section
[My 3D videos]
path      = D:\Video\3D
recursive = 1
include   = SBS, 3D
path: the full path to the folder with videos.
recursive = 1: include subfolders as well. Without this line only the folder itself is scanned.
include: show only videos whose title contains at least one of these words. Optional.
exclude: hide videos whose title contains any of these words. Optional.

Step 3. Save the file
Select the new source in the window's source list. The folder is scanned each time it is selected, so new files appear in the list right away. If the folder does not exist, the window shows Folder not found.

* The player detects the 3D format from the file name, for example movie_p.mp4 or movie SBS.mkv. If the name does not specify the format, the player's format detector tries to determine it during playback.
youtube

Method 2: a YouTube channel

The player shows the videos of the selected channel as a catalog and plays them without a browser. A filter by words in the title lets you keep only 3D videos and drop the rest.

Step 1. Add a section to catalog-user.txt
[4K Cine Trailer]
url          = https://www.youtube.com/@4kcinematrailer
include      = 3D, SBS
exclude      = anaglyph, VR
search_max   = 3000
search_limit = 200
url: the channel address.
include / exclude: words in video titles that select which videos to show and which to hide.
search_max: the maximum number of channel videos to look through.
search_limit: how many matching videos to put in the catalog.

Step 2. Click Rescan
To avoid triggering YouTube bot protection, the player never scans channels on its own. When the window opens, it shows the saved list. New videos are loaded only by the Rescan button and when you scroll to the end of the list, each time exactly as many as fit in the window.

Step 3. If YouTube asks you to confirm you are not a bot
This happens on university and office networks and with some large internet providers. Sign in to your YouTube account in the Firefox browser. The player will then use this sign in to access videos normally. Add the following line at the top of your catalog-user.txt:
cookies = firefox
Instead of firefox you can give the path to a cookies.txt file. Browsers based on Chrome (Chrome, Edge, Opera, Brave) will not work: they encrypt their cookies, so the player cannot use them.

* When YouTube refuses access, the player pauses its requests for 30 minutes. This protects your IP address from being blocked. The pause clears by itself after a while.
server

Method 3: a private catalog on your web hosting

For those who want to show their own 3D videos to friends, clients or their audience. The videos are stored on your web hosting; the player gets the list and plays them only with a login and password. You decide who can watch and who is allowed to save the videos. Try the demo, it is already included in the player: S3D demo server

What you need
An ordinary inexpensive hosting plan with PHP and Apache (.htaccess support). A dedicated server is not required.

Code package: your own video server

Step 1. Upload the package to your hosting
Unpack the archive and copy the folder to your hosting, for example to /demo/. Videos go into its media folder.

Step 2. Configure config.php
Open config.php in the package folder. It sets the file name of the admin panel and its initial password. Change both before the site becomes publicly accessible.

Step 3. Add users
In the admin panel, create users with passwords and mark which of them are allowed to save videos.

Step 4. Test the server
In the Windows command prompt:
curl -i -X POST -d "user=demo-user&pass=12345" "https://example.com/demo/list.php"
Response 200 with #private on the first line: the server works. Response 403: wrong login or password.

Step 5. Add the server to the player
[My server]
url      = https://example.com/demo/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved
Select the source and click Rescan. The next time the window opens, the list is taken from the cache and refreshed in the background.
cloudflare

Method 4: Cloudflare R2 + your web hosting

Cloudflare offers very favorable terms for storing and serving your files: up to 10 GB of storage for free and free outbound traffic, with moderate pricing beyond that. Use a small private hosting plan for logins and passwords, while the videos themselves are stored in Cloudflare R2 cloud storage instead of on the hosting. The hosting only checks the password and gives the player the links. The video goes to the viewer directly from R2, so large files take neither space nor traffic on your hosting. Try the demo, it is already included in the player: Cloudflare-R2 demo video

Cloudflare R2
Code package: R2 + video

Step 1. Create an R2 bucket
In the Cloudflare dashboard, open R2 object storage, create a bucket and upload your videos to it.

Step 2. Create an access key
In R2 object storage, under Account Details, click Manage next to API Tokens. Permissions: Object Read only; bucket: only yours (Apply to specific buckets only); TTL: Forever. After the token is created, copy the Access Key ID and the Secret Access Key. The secret is shown only once.

Step 3. Upload the package to your hosting
Copy the package folder to your hosting, for example to /cloudflare/. In config.php, enter the Account ID, both keys and the bucket name, as well as the admin panel file name and its password.

Step 4. Add users and test
Same as in Method 3: users in the admin panel, a test with the curl command.

Step 5. Add the server to the player
[My R2 server]
url      = https://example.com/cloudflare/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved
* The R2 key is stored only on the hosting; viewers never get it. The server issues temporary video links valid for 1 hour.

Saving videos

If the source allows saving, the window header shows a Save checkbox. When it is checked, a video is also written to disk while it plays: to the save_dir folder of the source section or, if none is set there, to the general save_dir. Videos from YouTube channels can always be saved. A private server allows saving only for the users the server owner has permitted. A local folder has no saving option, since the files are already on your computer.

The permission from a private server arrives together with the list when you click Rescan. Until Rescan is clicked, the window shows No save instead of the checkbox.

Troubleshooting

If the list is empty, the Media Manager window shows the reason.

No cache: press Rescan
The source has never been loaded. Click Rescan.

Folder not found
The folder does not exist. Check the path in path.

Wrong user or password
The server rejected the login or password. Check user and password.

Too many attempts, wait 15 min
Too many failed login attempts in a row. Wait 15 minutes.

Server not responding
No network connection, or the address in url is wrong.

YouTube: requests refused
YouTube considered the requests suspicious. Enable cookies = firefox and wait until the pause ends.
Homepage Terms & Conditions About Us Privacy Policy Business Info Contacts Payment Shipping Send Msg