Merge pull request #58 from LSchallot/windowsInstallationInfo

Updated Windows Installation Instructions
This commit is contained in:
TheFrenchGhosty 2021-03-03 20:59:32 +01:00 committed by GitHub
commit b69c2225df
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 25 additions and 3 deletions

View File

@ -43,11 +43,10 @@ Download the latest [release](https://github.com/TheFrenchGhosty/TheFrenchGhosty
## Installation (Windows):
Setup Windows Subsystem for Linux (WSL) and follow the Linux installation.
Installation using WSL (recommended): TODO
Detailed setup instruction need to be added to the documentation.
Why: Because Windows is using a path length limit of 260 characters, and because of the work required (and the fact that the Windows version was untested when it existed), Windows users needs to use the scripts in WSL. WSL bypass the path length limit so every video will get downloaded, however when playing it with a native Windows software the path length issue might be an issue, I can't do anything about that.
Installation using Cygwin, Git Bash or similar: [Here](docs/Cygwin-Git-Bash.md)
---

23
docs/Cygwin-Git-Bash.md Normal file
View File

@ -0,0 +1,23 @@
### Installation using Cygwin, Git Bash or similar:
#### Known Issues
* Windows has a hard limit of 260 characters for the filepath. This can cause issues with video downloading. It is recommended that you make your filepath as short as possible.
* If you are receiving a permission denied error when attempting to execute python, [this thread](https://stackoverflow.com/questions/56974927/permission-denied-trying-to-run-python-on-windows-10) may be helpful.
#### Required Software
In order to run these scripts, the following software packages must be installed:
* [Cygwin](https://www.cygwin.com/), [Git Bash](http://git-scm.com), or some other application that enables Bash functionality in Windows.
* [Python 3](https://www.python.org/downloads/)
* [yt-dlp](https://github.com/pukkandan/yt-dlp) - Make sure this is in your PATH.
* [ffmpeg](https://www.ffmpeg.org/) - Make sure this is in your PATH.
* [atomicparsley](https://github.com/wez/atomicparsley) (optional) - Make sure this is in your PATH.
#### Configuration
First, make sure that all dependencies are installed and your PATH is configured properly by opening your Bash terminal of choice and executing the following:
* `python --version`
* `yt-dlp --version`
* `ffmpeg --version`
If all of the above commands execute correctly, download the latest [release](https://github.com/TheFrenchGhosty/TheFrenchGhostys-YouTube-DL-Archivist-Scripts/releases) and follow the "Usage" section of this README.