Update readme with different frontend instructions.

This commit is contained in:
voussoir 2021-11-07 18:51:38 -08:00
parent ef356986a6
commit 1b422544d9
No known key found for this signature in database
GPG key ID: 5F7554F8C26DACCB

View file

@ -30,6 +30,7 @@ The reason for this is that youtube-dl is extremely configurable. Every user mig
## Features ## Features
- Web interface with video embeds - Web interface with video embeds
- Commandline interface for scripted use
- "Sub-box" page where newest videos from all channels are listed in order - "Sub-box" page where newest videos from all channels are listed in order
- Sort videos by date, duration, views, or random - Sort videos by date, duration, views, or random
- Background thread will refresh channels over time - Background thread will refresh channels over time
@ -72,20 +73,63 @@ YCDL has a core backend package and separate frontends that use it. These fronte
6. Run `python -c "import ycdl; print(ycdl)"` to confirm. 6. Run `python -c "import ycdl; print(ycdl)"` to confirm.
## Running YCDL Flask locally ## Running YCDL
In order to prevent the accidental creation of databases, you must first use `ycdl_cli.py init` to create your database.
### Running YCDL CLI
1. `cd` to the folder where you'd like to create the YCDL database. 1. `cd` to the folder where you'd like to create the YCDL database.
2. Start the webserver:
Windows: `python D:\Git\YCDL\frontends\ycdl_flask\ycdl_flask_dev.py` 2. Run `python frontends/ycdl_cli.py --help` to learn about the available commands.
Linux: `python ~/Git/YCDL/frontends/ycdl_flask/ycdl_flask_dev.py` 3. Run `python frontends/ycdl_cli.py init` to create a database in the current directory.
Note: Do not `cd` into the frontends folder. Stay in the folder that contains your `_ycdl` database and specify the full path of the frontend launcher. For example:
Windows:
D:\somewhere> python D:\Git\YCDL\frontends\ycdl_cli.py
Linux:
/somewhere $ python /Git/YCDL/frontends/ycdl_cli.py
It is expected that you create a shortcut file or launch script so you don't have to type the whole filepath every time.
### Running YCDL Flask locally
1. Use `ycdl_cli init` to create the database in the desired directory.
2. Run `python frontends/ycdl_flask/ycdl_flask_dev.py [port]` to launch the flask server. Port defaults to 5000 if not provided.
3. Open your web browser to `localhost:<port>`.
Note: Do not `cd` into the frontends folder. Stay in the folder that contains your `_ycdl` database and specify the full path of the frontend launcher. For example:
Windows:
D:\somewhere> python D:\Git\YCDL\frontends\ycdl_flask\ycdl_flask_dev.py 5001
Linux:
/somewhere $ python /Git/YCDL/frontends/ycdl_flask/ycdl_flask_dev.py 5001
Add `--help` to learn the arguments. Add `--help` to learn the arguments.
It is expected that you create a shortcut file or launch script so you don't have to type the whole filepath every time. It is expected that you create a shortcut file or launch script so you don't have to type the whole filepath every time.
3. YCDL will tell you what port it is running on. The default is 5000. Open your web browser to `localhost:<port>`. ### Running YCDL REPL
1. Use `ycdl_cli init` to create the database in the desired directory.
2. Run `python frontends/ycdl_repl.py` to launch the Python interpreter with the YCDLDB pre-loaded into a variable called `Y`. Try things like `Y.get_videos`.
Note: Do not `cd` into the frontends folder. Stay in the folder that contains your `_ycdl` database and specify the full path of the frontend launcher. For example:
Windows:
D:\somewhere> python D:\Git\YCDL\frontends\ycdl_repl.py
Linux:
/somewhere $ python /Git/YCDL/frontends/ycdl_repl.py
It is expected that you create a shortcut file or launch script so you don't have to type the whole filepath every time.
## Pairs well with... ## Pairs well with...