More formatting tweaks

pull/1226/head
Chaz Larson 2 years ago
parent 02af08edb0
commit b011878e3f

@ -56,21 +56,17 @@ Since most of this is typing commands into a terminal, you'll need to have a ter
````{tab} Linux ````{tab} Linux
<br/>
If your Linux system is remote to your computer, connect to it via SSH. That SSH session is the terminal you will be using, so leave it open. If your Linux system is remote to your computer, connect to it via SSH. That SSH session is the terminal you will be using, so leave it open.
If you are running this on a desktop Linux machine, start up the Terminal application. That window will be the terminal you will type commands into throughout this walkthrough, so leave it open. If you are running this on a desktop Linux machine, start up the Terminal application. That window will be the terminal you will type commands into throughout this walkthrough, so leave it open.
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
Open the Terminal app; this window will be the place you type commands throughout this walkthrough, so leave it open. The Terminal app is in Applications -> Utilities. Open the Terminal app; this window will be the place you type commands throughout this walkthrough, so leave it open. The Terminal app is in Applications -> Utilities.
You can also use iTerm or some other terminal app if you wish. If you don't know what that means, use Terminal. You can also use iTerm or some other terminal app if you wish. If you don't know what that means, use Terminal.
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
Use the Start menu to open PowerShell. This will be the window into which you type commands throughout this walkthrough, so leave it open. Use the Start menu to open PowerShell. This will be the window into which you type commands throughout this walkthrough, so leave it open.
<br/>
```` ````
### Installing Python. ### Installing Python.
@ -86,13 +82,10 @@ python3 --version
If this doesn't return `3.7.0` or higher, you'll need to get Python 3 installed. If this doesn't return `3.7.0` or higher, you'll need to get Python 3 installed.
````{tab} Linux ````{tab} Linux
<br/>
Describing a python install for any arbitrary linux is out of scope here, but if you're using Ubuntu, [this](https://techviewleo.com/how-to-install-python-on-ubuntu-linux/) might be useful. Describing a python install for any arbitrary linux is out of scope here, but if you're using Ubuntu, [this](https://techviewleo.com/how-to-install-python-on-ubuntu-linux/) might be useful.
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
Follow the instructions here: [Installing Python 3 on Mac OS X](https://docs.python-guide.org/starting/install3/osx/) Follow the instructions here: [Installing Python 3 on Mac OS X](https://docs.python-guide.org/starting/install3/osx/)
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
Go to http://www.python.org/download and download the next-to-latest minor version of Python for Windows in 32 or 64-bit as appropriate for your system [probably 64-bit]. As this is written, that's 3.10, while the latest is 3.11. Go to http://www.python.org/download and download the next-to-latest minor version of Python for Windows in 32 or 64-bit as appropriate for your system [probably 64-bit]. As this is written, that's 3.10, while the latest is 3.11.
@ -104,7 +97,6 @@ There is one dependency [`lxml`] that lags behind new Python releases; this will
Once downloaded, run the installer. Tick “Add to path” checkbox at the bottom and click “Install Now”. Once downloaded, run the installer. Tick “Add to path” checkbox at the bottom and click “Install Now”.
For Windows 10, you will need to enable scripts in PowerShell. Follow the instructions [here](https://windowsloop.com/enable-powershell-scripts-execution-windows-10) to do so. If you skip this step you're going to hit a hard stop in a moment. For Windows 10, you will need to enable scripts in PowerShell. Follow the instructions [here](https://windowsloop.com/enable-powershell-scripts-execution-windows-10) to do so. If you skip this step you're going to hit a hard stop in a moment.
<br/>
```` ````
--- ---
@ -122,17 +114,12 @@ git --version
If this doesn't return a version number, you'll need to get git installed. If this doesn't return a version number, you'll need to get git installed.
````{tab} Linux ````{tab} Linux
<br/>
The git install is discussed here: [Download for Linux and Unix](https://git-scm.com/download/linux) The git install is discussed here: [Download for Linux and Unix](https://git-scm.com/download/linux)
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
The git install is discussed here: [Git - Downloading Package](https://git-scm.com/download/mac) The git install is discussed here: [Git - Downloading Package](https://git-scm.com/download/mac)
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
Download the installer from [here](https://git-scm.com/download/windows) Download the installer from [here](https://git-scm.com/download/windows)
Run the install; you can probably just accept the defaults and click through except for the step that asks you to choose an editor; you probably want to choose something other than the default there: Run the install; you can probably just accept the defaults and click through except for the step that asks you to choose an editor; you probably want to choose something other than the default there:
@ -140,7 +127,6 @@ Run the install; you can probably just accept the defaults and click through exc
![Git Install](git-install.png) ![Git Install](git-install.png)
This install comes with its own command line interface. **Do not use this interface in this walkthrough**. Continue to do everything here in Powershell. This install comes with its own command line interface. **Do not use this interface in this walkthrough**. Continue to do everything here in Powershell.
<br/>
```` ````
--- ---
@ -228,7 +214,6 @@ Later on you can move it elsewhere if you want, but for now put it there. This
This walkthrough is going to use a "virtual environment", since that provides a simple way to keep the requirements for a given thing self-contained; think of it as a "sandbox" for this script. It also provides a clean way to recover from mistakes, and keeps the host system clean. This walkthrough is going to use a "virtual environment", since that provides a simple way to keep the requirements for a given thing self-contained; think of it as a "sandbox" for this script. It also provides a clean way to recover from mistakes, and keeps the host system clean.
````{tab} Linux ````{tab} Linux
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -249,20 +234,16 @@ sudo apt-get install python3.9-venv
``` ```
Then try the original venv command above again. Then try the original venv command above again.
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
python3 -m venv pmm-venv python3 -m venv pmm-venv
``` ```
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -276,7 +257,6 @@ Python was not found; run without arguments to install from the Microsoft Store,
``` ```
You apparently didn't check the “Add to path” checkbox above under [installing Python](#installing-python). "Repair" your Python install and check "add python to environment variables". You apparently didn't check the “Add to path” checkbox above under [installing Python](#installing-python). "Repair" your Python install and check "add python to environment variables".
<br/>
```` ````
<details> <details>
@ -303,25 +283,20 @@ If you aren't looking at an error, you're ready to move on.
That will create the virtual environment, and then you need to activate it: That will create the virtual environment, and then you need to activate it:
````{tab} Linux ````{tab} Linux
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
source pmm-venv/bin/activate source pmm-venv/bin/activate
``` ```
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
source pmm-venv/bin/activate source pmm-venv/bin/activate
``` ```
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -343,7 +318,6 @@ You apparently skipped the "enable scripts in Powershell" step above under [inst
You will need to take care of that before moving on. Follow the instructions [here](https://windowsloop.com/enable-powershell-scripts-execution-windows-10). You will need to take care of that before moving on. Follow the instructions [here](https://windowsloop.com/enable-powershell-scripts-execution-windows-10).
Once you have done that, try the activation step again. Once you have done that, try the activation step again.
<br/>
```` ````
That command will not produce any output if it works; it will display an error if a problem occurs. That command will not produce any output if it works; it will display an error if a problem occurs.
@ -370,31 +344,25 @@ An advantage of doing this in a virtual environment is that in the event somethi
**IMPORTANT: In the future, when you want to run the script, you will need to do this "activation" step every time. Not the venv creation, just the activation**: **IMPORTANT: In the future, when you want to run the script, you will need to do this "activation" step every time. Not the venv creation, just the activation**:
````{tab} Linux ````{tab} Linux
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
source pmm-venv/bin/activate source pmm-venv/bin/activate
``` ```
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
source pmm-venv/bin/activate source pmm-venv/bin/activate
``` ```
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
.\pmm-venv\Scripts\activate .\pmm-venv\Scripts\activate
``` ```
<br/>
```` ````
### Installing requirements ### Installing requirements
@ -478,31 +446,25 @@ The default config file contains a reference to a directory that will show an er
We'll create it here so the error doesn't show up later. We'll create it here so the error doesn't show up later.
````{tab} Linux ````{tab} Linux
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
mkdir config/assets mkdir config/assets
``` ```
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
mkdir config/assets mkdir config/assets
``` ```
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
mkdir config\assets mkdir config\assets
``` ```
<br/>
```` ````
### Setting up the initial config file ### Setting up the initial config file
@ -515,31 +477,25 @@ mkdir config\assets
First, make a copy of the template. This is going to create a copy of the base template that you can then edit. You only need to do this once. First, make a copy of the template. This is going to create a copy of the base template that you can then edit. You only need to do this once.
````{tab} Linux ````{tab} Linux
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
cp config/config.yml.template config/config.yml cp config/config.yml.template config/config.yml
``` ```
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
cp config/config.yml.template config/config.yml cp config/config.yml.template config/config.yml
``` ```
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
copy .\config\config.yml.template .\config\config.yml copy .\config\config.yml.template .\config\config.yml
``` ```
<br/>
```` ````
Now open the copy in an editor: Now open the copy in an editor:
@ -637,7 +593,6 @@ deactivate
### I want to update to the latest version of PMM ### I want to update to the latest version of PMM
````{tab} Linux ````{tab} Linux
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -646,10 +601,8 @@ git pull
source pmm-venv/bin/activate source pmm-venv/bin/activate
python -m pip install -r requirements.txt python -m pip install -r requirements.txt
``` ```
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -658,10 +611,8 @@ git pull
source pmm-venv/bin/activate source pmm-venv/bin/activate
python -m pip install -r requirements.txt python -m pip install -r requirements.txt
``` ```
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -670,13 +621,11 @@ git pull
.\pmm-venv\Scripts\activate .\pmm-venv\Scripts\activate
python -m pip install -r requirements.txt python -m pip install -r requirements.txt
``` ```
<br/>
```` ````
### I want to use the develop branch ### I want to use the develop branch
````{tab} Linux ````{tab} Linux
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -686,10 +635,8 @@ git pull
source pmm-venv/bin/activate source pmm-venv/bin/activate
python -m pip install -r requirements.txt python -m pip install -r requirements.txt
``` ```
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -699,10 +646,8 @@ git pull
source pmm-venv/bin/activate source pmm-venv/bin/activate
python -m pip install -r requirements.txt python -m pip install -r requirements.txt
``` ```
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -712,7 +657,6 @@ git pull
.\pmm-venv\Scripts\activate .\pmm-venv\Scripts\activate
python -m pip install -r requirements.txt python -m pip install -r requirements.txt
``` ```
<br/>
```` ````
### I want to use the nightly branch ### I want to use the nightly branch

@ -11,11 +11,11 @@ The default config links to two of them:
The first will create: The first will create:
Newly Released - Newly Released
New Episodes - New Episodes [TV libraries only]
The second will create: The second will create:
IMDb Popular - IMDb Popular
IMDb Top 250 - IMDb Top 250
IMDb Lowest Rated - IMDb Lowest Rated

@ -3,31 +3,25 @@ If the default metadata files do not allow you to create the collections you wan
First, open the metadata file [this will create the file if it doesn't already exist]: First, open the metadata file [this will create the file if it doesn't already exist]:
````{tab} Linux ````{tab} Linux
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
nano "config/Movies.yml" nano "config/Movies.yml"
``` ```
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
nano "config/Movies.yml" nano "config/Movies.yml"
``` ```
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
notepad "config\Movies.yml" notepad "config\Movies.yml"
``` ```
<br/>
```` ````
In this file, add the following, exactly as it is shown here: In this file, add the following, exactly as it is shown here:

@ -1,13 +1,15 @@
The commands you've been using in this walkthrough runn Plex-Meta-Manager immediately. The commands you've been using in this walkthrough run Plex-Meta-Manager immediately then quit.
Plex Meta Manager also features multiple layers of scheduling, which you can leverage to Plex Meta Manager also features multiple layers of scheduling, which you can leverage to control when various activities take place.
You can run PMM in the background, telling it to wake up and process your libraries at fixed times during the day. The default behavior in this regard is to wake up at 5AM and process the config. - You can run PMM in the background, telling it to wake up and process your libraries at fixed times during the day. The default behavior in this regard is to wake up at 5AM and process the config. If you leave the `-r` off the commands you have been using in this walkthrough, that's what will happen.
You can skip using that internal schedule and just do manual runs as you have been doing throughout this walkthrough using standard tools available in your OS. You can control when PMM wakes up with the [time-to-run](../../../home/environmental.md) env-var/runtime flag.
Details on setting this up are found [here](../scheduling.md). - You can skip using that internal schedule and just do manual runs as you have been doing throughout this walkthrough using standard tools available in your OS.
In addition, individual items *within* the configuration can be scheduled to take place at certain times *provided PMM is running at that time*. For example, you can tell PMM only to apply overlays on Tuesdays or the like. YOu can then schedule manual runs every day at noon and overlays will only get processed when it runs on Tuesday. This sort of schedule *will not* make PMM start up if it is not already running. If you don't arrange for PMM to be run on Tuesday, your overlays would never be processed in this example. Details on setting this up are found [here](../../../home/guides/scheduling.md).
Details on this level of scheduling are found [here](../../../metadata/details/schedule.md) - In addition, individual items *within* the configuration can be scheduled to take place at certain times *provided PMM is running at that time*. For example, you can tell PMM only to apply overlays on Tuesdays or the like. YOu can then schedule manual runs every day at noon and overlays will only get processed when it runs on Tuesday. This sort of schedule *will not* make PMM start up if it is not already running. If you don't arrange for PMM to be run on Tuesday, your overlays would never be processed in this example.
Details on this level of scheduling are found [here](../../../metadata/details/schedule.md)

@ -1,5 +1,4 @@
````{tab} Linux ````{tab} Linux
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -23,10 +22,8 @@ sudo apt install nano
``` ```
You can use any other text editor you wish, provided it saves files as PLAIN TEXT. `vi`, `emacs`, etc. You can use any other text editor you wish, provided it saves files as PLAIN TEXT. `vi`, `emacs`, etc.
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
@ -36,17 +33,14 @@ nano config/config.yml
Im using `nano` here simply because its built into OSX. You can use any other text editor you wish, provided it saves files as PLAIN TEXT. BBedit, TextMate, VSCode, etc. Im using `nano` here simply because its built into OSX. You can use any other text editor you wish, provided it saves files as PLAIN TEXT. BBedit, TextMate, VSCode, etc.
A common mistake is using TextEdit.app, which saves files as RTF by default. A common mistake is using TextEdit.app, which saves files as RTF by default.
<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
[type this into your terminal] [type this into your terminal]
``` ```
notepad .\config\config.yml notepad .\config\config.yml
``` ```
Im using `notepad` here simply because its built into Windows. You can use any other text editor you wish, provided it saves files as PLAIN TEXT. Im using `notepad` here simply because its built into Windows. You can use any other text editor you wish, provided it saves files as PLAIN TEXT.
<br/>
```` ````
From here on in, when this walkthrough says "open the config file", I mean this `nano` or `notepad` command. **Don't copy the template again**. From here on in, when this walkthrough says "open the config file", I mean this `nano` or `notepad` command. **Don't copy the template again**.

@ -1,14 +1,9 @@
````{tab} Linux ````{tab} Linux
<br/>
If you're using `nano`, type control-`x`, then `y`, then the enter key. If you're using `nano`, type control-`x`, then `y`, then the enter key.
<br/>
```` ````
````{tab} OS X: ````{tab} OS X:
<br/> If you're using `nano`, type control-`x`, then `y`, then the enter key.
If you're using `nano`, type control-`x`, then `y`, then the enter key.<br/>
```` ````
````{tab} Windows: ````{tab} Windows:
<br/>
If you're using `notepad`, type control-`s` or choose `Save` from the `File` menu. If you're using `notepad`, type control-`s` or choose `Save` from the `File` menu.
<br/>
```` ````

@ -0,0 +1,21 @@
### Prepare a small test library [optional]
While going through this process, Plex-Meta-Manager is going to load the movies in your library, create some collections, and apply some overlays. If you have a large library, this will be very time-consuming.
For learning and testing, you would be well-advised to create a small test library of a reasonable size, where reasonable it probably below a thousand.
The author has a small library of 10 movies that is used for fast tests.
For best results with this walkthrough, your test library will contain:
- At least two comedy movies released since 2012.
- At least two movies from the [IMDB top 250](https://www.imdb.com/chart/top/).
- At least two movies from [IMDB's Popular list](https://www.imdb.com/chart/moviemeter).
- At least two movies from [IMDB's Lowest Rated](https://www.imdb.com/chart/bottom).
- A couple different resolutions among the movies.
That will ensure there's something to go into each of the example collections that will be created.
The advantage of the small test library is that it will reduce the time needed to see results. Running some of these default collections against a library of a few thousand movies can take hours, and for iterative testing it's useful to have something that will run in a few minutes or seconds.
You can set up a test library like this using symlinks without copying files.
Loading…
Cancel
Save