mirror of
https://github.com/beetbox/beets.git
synced 2025-12-06 16:42:42 +01:00
aa31fea037
*All* URLs were checked manually, but only once per domain! I mostly concerned myself with URLs in documentation rather than source code because the latter may or may not have impactful changes, while the former should be straight forward. Changes in addition to simply adding an s: - changed pip and pypi references as their location has changed - MPoD (iOS app) url redirects to Regelian, so I replaced those - updated homebrew references Notable observations: - beets.io does have HTTPS set up properly (via gh-pages) - beatport.py uses the old HTTP url for beatport - as does lyrics.py for lyrics.wikia.com - https://tomahawk-player.org/ expired long ago, but the http page redirects to https regardless - none of the sourceforge subdomains have https (in 2019!)
43 lines
1.4 KiB
ReStructuredText
43 lines
1.4 KiB
ReStructuredText
PlexUpdate Plugin
|
|
=================
|
|
|
|
``plexupdate`` is a very simple plugin for beets that lets you automatically
|
|
update `Plex`_'s music library whenever you change your beets library.
|
|
|
|
To use ``plexupdate`` plugin, enable it in your configuration
|
|
(see :ref:`using-plugins`).
|
|
Then, you'll probably want to configure the specifics of your Plex server.
|
|
You can do that using an ``plex:`` section in your ``config.yaml``,
|
|
which looks like this::
|
|
|
|
plex:
|
|
host: localhost
|
|
port: 32400
|
|
token: token
|
|
|
|
The ``token`` key is optional: you'll need to use it when in a Plex Home (see Plex's own `documentation about tokens`_).
|
|
|
|
To use the ``plexupdate`` plugin you need to install the `requests`_ library with:
|
|
|
|
pip install requests
|
|
|
|
With that all in place, you'll see beets send the "update" command to your Plex
|
|
server every time you change your beets library.
|
|
|
|
.. _Plex: https://plex.tv/
|
|
.. _requests: https://docs.python-requests.org/en/latest/
|
|
.. _documentation about tokens: https://support.plex.tv/hc/en-us/articles/204059436-Finding-your-account-token-X-Plex-Token
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
The available options under the ``plex:`` section are:
|
|
|
|
- **host**: The Plex server name.
|
|
Default: ``localhost``.
|
|
- **port**: The Plex server port.
|
|
Default: 32400.
|
|
- **token**: The Plex Home token.
|
|
Default: Empty.
|
|
- **library_name**: The name of the Plex library to update.
|
|
Default: ``Music``
|