From b4620504b8c8d8351c96b819a547637c5706dbfc Mon Sep 17 00:00:00 2001 From: simon Date: Sat, 5 Nov 2022 11:36:53 +0700 Subject: [PATCH] improve manual import docs --- docs/Settings.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/Settings.md b/docs/Settings.md index ad51259..72e69e7 100644 --- a/docs/Settings.md +++ b/docs/Settings.md @@ -129,6 +129,8 @@ Additional database functionality. The button **Delete all queued** will delete all pending videos from the download queue. The button **Delete all ignored** will delete all videos you have previously ignored. ## Manual Media Files Import +NOTE: This is inherently error prone, as there are many variables, some outside of the control of this project. Read this carefully and use at your own risk. + Add the files you'd like to import to the */cache/import* folder. Only add files, don't add subdirectories. All files you are adding, need to have the same *base name* as the media file. Then start the process from the settings page *Manual Media Files Import*. Valid media extensions are *.mp4*, *.mkv* or *.webm*. If you have other file extensions or incompatible codecs, convert them first to mp4. **Tube Archivist** can identify the videos with one of the following methods. @@ -146,11 +148,9 @@ Detect the YouTube ID from filename, this accepts the default yt-dlp naming conv - The YouTube ID in square brackets at the end of the filename is the crucial part. ### Offline import: -**NOTE**: This is untested. Please provide feedback. - If the video you are trying to import is not available on YouTube any more, **Tube Archivist** can import the required metadata: - The file `.info.json` is required to extract the required information. -- Add the thumbnail as `.`, where valid file extensions are *.jpg*, *.png* or *.webp*. If there is no thumbnail file, **Tube Archivist** will try to extract it from the media file or will fallback to a default thumbnail. +- Add the thumbnail as `.`, where valid file extensions are *.jpg*, *.png* or *.webp*. If there is no thumbnail file, **Tube Archivist** will try to extract the embedded cover from the media file or will fallback to a default thumbnail. - Add subtitles as `..vtt` where *lang* is the two letter ISO country code. This will archive all subtitle files you add to the import folder, independent from your configurations. Subtitles can be archived and used in the player, but they can't be indexed or made searchable due to the fact, that they have a very different structure than the subtitles as **Tube Archivist** needs them. - For videos, where the whole channel is not available any more, you can add the `.info.json` file as generated by *youtube-dl/yt-dlp* to get the full metadata. Alternatively **Tube Archivist** will extract as much info as possible from the video info.json file.