beets/docs/plugins
Max Goltzsche 58e5b02929
smartplaylist: add --uri-format option
Beets web API already allows remote players to access audio files but it doesn't provide a way to expose the playlists defined using the smartplaylist plugin.
Now the smartplaylist plugin provides an option to generate ID-based item URIs/URLs instead of paths.
Once playlists are generated this way, they can be served using a regular HTTP server such as nginx.

To provide sufficient flexibility for various ways of integrating beets remotely (e.g. beets API, beets API with context path, AURA API, mopidy resource URI, etc), the new option has been defined as a template with an `$id` placeholder (assuming each remote integration requires a different path schema but they all rely on using the beets item `id` as identifier/path segment).

To prevent local path-related plugin configuration from leaking into a HTTP URL-based playlist generation (invoked with CLI option in addition to the local playlists generated into another directory), setting the new option makes the plugin ignore the other path-related options `prefix`, `relative_to`, `forward_slash` and `urlencode`.

Usage examples:
* `beet splupdate --uri-format 'http://beets:8337/item/$id/file'` (for beets web API)
* `beet splupdate --uri-format 'http://beets:8337/aura/tracks/$id/audio'` (for AURA API)

(While it was already possible to generate playlists containing HTTP URLs previously using the `prefix` option, it did not allow to generate ID-based URLs pointing to the beets web API but required to expose the audio files using a web server directly and refer to them using their file system `$path`.)

Relates to #5037
2023-12-16 05:37:27 +01:00
..
absubmit.rst Fix various typos 2023-08-09 21:26:15 -04:00
acousticbrainz.rst Deprecate absubmit and update acousticbrainz plugins 2023-02-20 17:42:07 -05:00
advancedrewrite.rst advancedrewrite: Add note about quoting issues to docs 2023-12-15 17:14:00 +01:00
albumtypes.rst Add note to albumtypes plugin docs about #4528 2023-02-28 08:53:21 +01:00
aura.rst Fix various typos 2023-08-09 21:26:15 -04:00
autobpm.rst Add autobpm plugin 2023-09-30 16:25:06 +01:00
badfiles.rst Add docs for badfiles' check_on_import option. 2021-03-24 16:55:28 -05:00
bareasc.rst Make unicode handling explicit, to support python 2 and 3. 2021-03-16 16:29:57 +00:00
beatport.rst add cl formatting to beatport docs 2022-06-08 22:11:51 -07:00
beetsweb.png
bpd.rst
bpm.rst
bpsync.rst
bucket.rst
chroma.rst
convert.rst Fix m3u8 wikipedia link in convert plugin docs 2023-04-21 22:12:17 +02:00
deezer.rst Add changelog and docs 2023-07-10 08:32:29 -04:00
discogs.rst Add singleton matching info to Discogs plugin docs 2023-07-20 09:12:42 +02:00
duplicates.rst
edit.rst
embedart.rst Updated language 2023-04-21 07:58:37 -04:00
embyupdate.rst docs[embyupdate]: add docs for userid option 2023-08-24 20:12:04 -07:00
export.rst Add "beet export --album" (matching "beet info --album") 2021-10-27 08:55:36 -07:00
fetchart.rst Fix the error with CAA where the pre-sized thumbs of release groups would be ignored 2023-10-07 21:25:02 +02:00
filefilter.rst
fish.rst Tiny wording tweaks for #4281 2022-02-16 16:34:38 -05:00
freedesktop.rst
fromfilename.rst
ftintitle.rst
fuzzy.rst
gmusic.rst remove the gmusic plugin 2021-10-30 14:46:14 +02:00
hook.rst
ihate.rst
importadded.rst
importfeeds.rst Add docs for new importfeeds list format in #4863 2023-07-27 07:56:14 +02:00
index.rst Fix capitalization 2023-10-25 15:11:03 -04:00
info.rst Add "beet info --album" to the plugin documentation too 2021-10-26 09:09:44 -07:00
inline.rst
ipfs.rst
keyfinder.rst
kodiupdate.rst kodiupdate: Support multiple instances 2021-12-12 13:39:18 +01:00
lastgenre.rst
lastimport.rst
limit.rst Fix various typos 2023-08-09 21:26:15 -04:00
loadext.rst
lyrics.rst Add config option to prefer synced lyrics over plain 2023-11-05 11:26:33 -05:00
mbcollection.rst
mbsubmit.rst mbsubmit: document new prompt choices 2023-12-05 19:21:38 +02:00
mbsync.rst
metasync.rst
missing.rst
mpdstats.rst
mpdupdate.rst
parentwork.rst
permissions.rst
play.rst docs: fix some markup issues and typos 2019-04-27 12:43:13 +10:00
playlist.rst Further improve playlist plugin docs 2022-11-29 08:27:35 +01:00
plexupdate.rst Revert the configuration section back to how it was before 2023-01-22 14:37:45 +01:00
random.rst
replaygain.rst Fix various typos 2023-08-09 21:26:15 -04:00
rewrite.rst Final take on rewording rewrite plugin docs 2023-09-08 19:24:34 +02:00
scrub.rst
smartplaylist.rst smartplaylist: add --uri-format option 2023-12-16 05:37:27 +01:00
sonosupdate.rst Update a lot of URLs to use HTTPS 2019-06-05 03:11:49 +02:00
spotify.rst Merge pull request #4352 from arsaboo/spotify_extend 2022-06-12 17:33:29 -04:00
subsonicplaylist.rst
subsonicupdate.rst Add docs for subsonicupdate features in #4862 2023-07-27 07:41:50 +02:00
substitute.rst Fix typos 2023-09-25 12:52:26 +08:00
the.rst
thumbnails.rst
types.rst
unimported.rst feat(unimported): support excluding subdirectories 2021-10-12 17:28:43 +00:00
web.rst
zero.rst