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.
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
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.
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.
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 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.