Integration

Installer command line parameters

NSIS is used for installer creation so all its command line parameters are available (like silent install or specifying output directory). For list of possible parameters read NSIS documentation: section Installer Usage.

Additionally are available next parameters:

/NODESKTOPICON - do not create Desktop icon
/PORTABLE - install portable version

Command line interface

Argument	Description
--download	Switch to Simple Mode, paste URL from Clipboard and start downloading
--convert	Switch to Convert Mode, paste URL from Clipboard and start converting
--analyze	Switch to Advanced Mode, paste URL from Clipboard and start analysis
--magnet URL	Use URL and mode from magnet link and start processing
--no-langs	Ignore translation libraries
--output-directory	Override directory where to place downloaded files
--output-format	Override format to convert to (Convert Mode only). Expected extension without a dot e.g. `--output-format=mp4`
--finish-action	The only acceptable value is `exit`. When specified, program exits after downloading
--preset	Override preset to use. Expects name of preset configured via menu `Tools Preset`
--criteria	Override source quality to use. Acceptable values: `smallest_video, 144p, 240p, 360p, 480p, 720p, 1080p, 1440p, 2160p, 3072p, best_video, 32k, 64k, 128k, 192k, 256k, best_audio`

Example:

3dyd.exe --analyze

Magnet link format: s3dyd://action=URL, where action is one of 'download', 'convert', 'analyze'. Example:

3dyd.exe --magnet s3dyd://download=https://www.youtube.com/watch?v=gtktg9hbC_g

If program installed not portable, it registers in the system custom protocol s3dyd. In this case magnet links can be run without specifying program path. Example (will work only if program installed nonportable): s3dyd://analyze=youtube.com/watch?v=gtktg9hbC_g.

This can be used to connect 3D Youtube Downloader with other programs. For example, here is command for analysis foo_youtube clips using foo_run in foobar2000:

s3dyd://analyze=%path%

Portable mode

Program can be used in portable and non-portable mode. The difference is where the program stores its settings and intermediate data (e.g. the search results or content of the feeds). In non-portable mode the settings are stored in registry and data is stored in application data folders of current user. In portable mode everything is stored in the program directory.

32-bit and 64-bit versions can be placed in the same directory, intermediate data and program settings in this case will remain be separate.

Linux support

There is no native version for Linux, but it should work ok under Wine.

Better to set Windows version for the program to Windows XP, otherwise some UI parts may be displayed incorrectly.

If you see the error containing SSL connect error (35), go to menu Tools Options Network libcurl and select a variant containing OpenSSL.

This actually might be caused by missing libgnutls package, which is used to provide schannel functionality. This package is an optional dependency for Wine (at least on some distributions), so its installation should resolve this issue. Package name differs across Linux distributions and Wine versions, so no exact name here.

Windows support

The minimum supported Windows version for 32-bit program version is Windows XP SP3 with SSE-capable CPU. In case of 64-bit program version, the minimum supported Windows version is Windows 8.

Native SSL backend on Windows XP might be outdated. If you are getting errors mentioning SSL connect error (35), go to Tools Options Network libcurl and select a variant containing OpenSSL.

If 32-bit version stopped working, you can notify about this, as such issues are not always noticeable from the development point of view.

Help Miscellaneous Integration