From b1435434e6d2521c2bf72e52ed1b265ac2983c95 Mon Sep 17 00:00:00 2001 From: Stephen Herbein Date: Thu, 10 Feb 2022 21:55:14 -0800 Subject: [PATCH] docs: add a note that importing requires there be no subdirectories (#170) Also include some bash snippets to help users with existing video libraries containing subdirectories get their files all in one directory quickly. Co-authored-by: Stephen Herbein --- docs/Settings.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/Settings.md b/docs/Settings.md index 22d1484..19957f3 100644 --- a/docs/Settings.md +++ b/docs/Settings.md @@ -69,7 +69,7 @@ Create a zip file of the metadata and select **Max auto backups to keep** to aut Additional database functionality. ## Manual Media Files Import -So far this depends on the video you are trying to import to be still available on YouTube to get the metadata. Add the files you like to import to the */cache/import* folder. Then start the process from the settings page *Manual Media Files Import*. Make sure to follow one of the two methods below. +So far this depends on the video you are trying to import to be still available on YouTube to get the metadata. Add the files you'd like to import to the */cache/import* folder. Then start the process from the settings page *Manual Media Files Import*. Make sure to follow one of the two methods below. ### Method 1: Add a matching *.json* file with the media file. Both files need to have the same base name, for example: @@ -86,6 +86,7 @@ Detect the YouTube ID from filename, this accepts the default yt-dlp naming conv ### Some notes: - This will **consume** the files you put into the import folder: Files will get converted to mp4 if needed (this might take a long time...) and moved to the archive, *.json* files will get deleted upon completion to avoid having duplicates on the next run. +- There should be no subdirectories added to */cache/import*, only video files. If your existing video library has video files inside subdirectories, you can get all the files into one directory by running `find ./ -mindepth 2 -type f -exec mv '{}' . \;` from the top-level directory of your existing video library. You can also delete any remaining empty subdirectories with `find ./ -mindepth 1 -type d -delete`. - Maybe start with a subset of your files to import to make sure everything goes well... - Follow the logs to monitor progress and errors: `docker-compose logs -f tubearchivist`.