Commit graph

1017 commits

Author SHA1 Message Date
octos
5f6d1f0f96
improve readability 2019-07-31 22:41:32 -05:00
Samuel Nilsson
60c174101f ffmpeg replaygain backend: Only calculate replaygain for audio stream. Fixed documentation for backend option. 2019-07-29 10:32:19 +02:00
Zsin Skri
e3645dfd59
Merge branch 'master' into r128-targetlevel-config 2019-07-25 23:22:32 +02:00
Zsin Skri
a9f70f8151 apply suggested improvements
Apply improvements suggested in GitHub PullRequest #3065:
- be idiomatic
  - 0 is falsy
  - check enum equality, not identity
  - mutate list by constructing a new one
- improve documentation
  - fix a typo
  - do not mention deprecation of a config option
2019-07-26 01:02:03 +02:00
Adrian Sampson
9392256993 Spelling & changelog for #3334 2019-07-24 22:13:53 -04:00
Adrian Sampson
84032e56e2 Merge pull request #3334 from MartyLake/martylake_add_forward_slash_option
Add option to force forward slashes in paths
2019-07-24 22:11:59 -04:00
MartyLake
c52973e1c0 Review: Adds missing point to finish sentences 2019-07-24 09:53:54 +02:00
Paul Malcolm
5f9a394ca9 Issue #2860 Fetch more acousticbrainz fields 2019-07-23 20:25:26 -04:00
MartyLake
1a4699d0ee Add documentation 2019-07-23 23:46:31 +02:00
Zsin Skri
fbc8cc484d update replaygain target level documentation
- document `r128_targetlevel`
- explain difference between `targetlevel` and `r128_targetlevel`
- deprecate `method` option: use `targetlevel` instead.
2019-07-22 13:42:26 +02:00
Zsin Skri
f9ff56f496 improve wording in the ffmpeg replaygain backend
This commit mostly addresses feedback:
- remove some unused parenthesis
- fix a typo
- expand some docstrings
- document that ffmpeg is usually easy to install
2019-07-21 01:18:49 +02:00
Zsin Skri
c3af5b3763 replaygain: add ffmpeg backend
Add replaygain backend using ffmpeg's ebur128 filter.

The album gain is calculated as the mean of all BS.1770 gating block powers.
Besides differences in gating block offset, this should be equivalent to a
BS.1770 analysis of a proper concatenation of all tracks.

Just calculating the mean of all track gains (as implemented by the bs1770gain
backend) yields incorrect results as that would:
- completely ignore track lengths
  - just using length in seconds won't work either (e.g. BS.1770 ignores
    passages below a threshold)
- take the mean of track loudness, not power

When using the ffmpeg replaygain backend to create R128_*_GAIN tags, the
targetlevel will be set to -23 LUFS. GitHub PullRequest #3065 will make this
configurable.
It will also skip peak calculation, as there is no R128_*_PEAK tag.

It is checked if the libavfilter library supports replaygain calculation. Before
version 6.67.100 that did require the `--enable-libebur128` compile-time-option,
after that the ebur128 library is included in libavfilter itself. Thus we
require either a recent enough libavfilter version or the `--enable-libebur128`
option.
2019-07-19 21:54:47 +02:00
Adrian Sampson
23c9f87142 Typography (#3319) 2019-06-28 09:24:15 -04:00
Justin Mayer
9e5c45d6dd
Convert plugin skips previously-converted files
Clarifies documentation so it's clear that one can run `beet convert` without fearing that previously-converted files will be needlessly re-converted.
2019-06-28 14:47:38 +02:00
Susanna Maria
f254b33c6e Findings from PR 2019-06-25 20:22:26 +02:00
Susanna Maria
2bfc7723fa Fix findings from travis-ci 2019-06-23 18:01:21 +02:00
Susanna Maria
f99b4841df Better documentation 2019-06-23 17:04:43 +02:00
Susanna Maria
1643eea3f5 Parameter handling 2019-06-23 13:04:17 +02:00
Susanna Maria
43d7446df7 Right listing of mosaic plugin 2019-06-22 17:44:18 +02:00
Susanna Maria
2477443e58 Add mosaic plugin 2019-06-22 17:01:43 +02:00
Carl Suster
bf26e2cc7e
docs: mention mpdstats needs to be running
Clarify that `mpdstats` is an MPD client and needs to be running all the time to collect statistics.

See https://discourse.beets.io/t/mpdstats-requirements/796
2019-06-11 18:34:33 +10:00
Adrian Sampson
6a9616796c Break up a long paragraph 2019-06-08 21:38:42 -04:00
Adrian Sampson
bfb94363c3 Changelog & doc tweaks for #3279 2019-06-08 21:37:24 -04:00
Adrian Sampson
c2fdf04539 Merge pull request #3279 from dosoe/beets_parentwork_3
add parentwork plugin
2019-06-08 21:35:05 -04:00
Dorian Soergel
fd14b5b649 docstrings and style 2019-06-08 22:55:05 +02:00
Dorian Soergel
2c3389beae
Update docs/plugins/parentwork.rst
Co-Authored-By: Adrian Sampson <adrian@radbox.org>
2019-06-08 22:46:47 +02:00
Dorian Soergel
c8c206f19e
Update docs/plugins/parentwork.rst
Co-Authored-By: Adrian Sampson <adrian@radbox.org>
2019-06-08 22:46:32 +02:00
Dorian Soergel
022e3d44ea
Update docs/plugins/parentwork.rst
Co-Authored-By: Adrian Sampson <adrian@radbox.org>
2019-06-08 22:46:17 +02:00
Samuel Nilsson
b8b99d9396 Merge branch 'master' into replaygain 2019-06-08 16:15:27 +02:00
FichteFoll
c144141e9a
Update a few more http URLs to https that I missed
Should really be all now (pending the next commit).
2019-06-05 23:07:11 +02:00
Dorian Soergel
8363dedaeb logging and minor comments 2019-06-05 11:10:11 +02:00
FichteFoll
aa31fea037
Update a lot of URLs to use HTTPS
*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!)
2019-06-05 03:11:49 +02:00
Dorian Soergel
380003a2fb fix documentation 2019-06-03 20:01:02 +02:00
Carl Suster
62aa358ce7 bpd: bump protocol version to 0.16 2019-06-02 23:37:07 +10:00
Carl Suster
fdd809fd36 bpd: support more tagtypes 2019-06-02 23:37:07 +10:00
Adrian Sampson
cd66c5d752 Link to beet-summarize (fix #3177) 2019-06-01 12:03:03 -04:00
Dorian Soergel
b28d685059 wrong file name for parentwork documentation 2019-05-31 15:13:55 +02:00
Dorian Soergel
080680c950 add parentwork plugin, first try 2019-05-31 14:35:51 +02:00
Carl Suster
9b0fcff216 playlist: remove "smart" from title in docs 2019-04-27 12:43:33 +10:00
Carl Suster
2e0230789f docs: fix some markup issues and typos 2019-04-27 12:43:13 +10:00
Adrian Sampson
8b23411767 Simplify docs for #3220 2019-04-21 20:40:18 -04:00
Adrian Sampson
5f9b28124d Merge pull request #3220 from rain0r/3219
Update __init__.py
2019-04-21 20:39:46 -04:00
Rainer Hihn
b7d3ef6274 - Improved doc and changelog
- Cleaner implementation of mutual excursion of the command line
arguments.
2019-04-21 18:32:41 +02:00
Jack Wilsdon
f5f9aed641
Add loadext plugin 2019-04-21 15:10:28 +01:00
Rainer Hihn
e4b2e7b476 Made -a and -A mutually exclusive. 2019-04-19 20:58:13 +02:00
Carl Suster
21cba304bd mpdupdate: use MPD_PORT env variable 2019-04-19 17:35:42 +10:00
Carl Suster
dc5f110844 mpdstats: use MPD_PORT env variable 2019-04-19 17:35:42 +10:00
Carl Suster
241e23eae8 bpd: document new control_port config 2019-04-10 15:54:41 +10:00
Carl Suster
e70b2134e4 bpd: update documentation 2019-04-08 11:40:24 +10:00
Jan Holthuis
fdd41b301d docs: Update documentation regarding playlist plugin 2019-02-17 20:39:54 +01:00
Adrian Sampson
3633c1e27f Tiny doc refinements for #3145 2019-02-17 13:17:22 -05:00
Adrian Sampson
00667bda0f Merge pull request #3145 from Holzhaus/playlist-plugin
Playlist plugin
2019-02-17 13:16:26 -05:00
Jan Holthuis
34cdeeefb7 docs: Reword documentation of playlist plugin's relative_to option 2019-02-17 15:35:30 +01:00
Jan Holthuis
cc501be2d9 docs: Add documentation for the playlist plugin 2019-02-17 14:38:36 +01:00
Adrian Sampson
e8d58432c0
Merge pull request #3142 from vmassuchetto/master
added beets-ydl plugin
2019-02-15 09:52:06 -07:00
Adrian Sampson
69fbba1eed
Merge pull request #3144 from Holzhaus/add-id3v23-to-convert
Add id3v23 option to convert plugin
2019-02-15 09:51:46 -07:00
Jan Holthuis
0579046487 docs: Add new id3v23 config option to convert plugin documentation 2019-02-14 23:42:36 +01:00
Vinicius Massuchetto
9090401489
added beets-ydl plugin 2019-02-13 07:48:14 -02:00
Samuel Nilsson
1619761bd6 Updated docs with per_disc ReplayGain configuration. 2019-02-06 09:38:03 +01:00
Iris Wildthyme
2b82831b7b added --nocopy support 2019-01-30 16:36:46 -05:00
nichobi
37d918a19e
docs: restore replaygain option for ffmpeg backend 2019-01-25 15:48:49 +01:00
nichobi
b7f75878b0
docs: remove references to bs1770gain for #3127 2019-01-24 16:07:44 +01:00
Rahul Ahuja
b50e148bec use official client ID/secret, remove usage from docs 2019-01-21 08:32:57 -08:00
Rahul Ahuja
f61aacf04b remove tokenfile doc, use active voice 2019-01-20 14:40:32 -08:00
Rahul Ahuja
7b1e64a61f doc wording 2019-01-20 13:07:12 -08:00
Rahul Ahuja
645c053a1c doc wording/formatting 2019-01-20 12:55:43 -08:00
Rahul Ahuja
2da738b078 remove unused doc 2019-01-20 12:50:28 -08:00
Rahul Ahuja
082357b063 document new functionality, use Spotify ID for AlbumInfo.album_id 2019-01-20 12:40:11 -08:00
Samuel Nilsson
a928dbc470 Added contextpath configuration to subsonicupdate plugin. Fixed bug in
subsonicupdate port configuration.
2018-10-10 21:22:31 +02:00
Jack Wilsdon
5ad16983d4
Fix miscellaneous typos 2018-10-09 01:11:06 +01:00
Adrian Sampson
5cb1bea1a6 Add a warning to the bucket docs (fix #3045) 2018-10-08 17:45:27 -04:00
Adrian Sampson
eec5bfe73a Fiddle with some whitespace 2018-08-30 14:58:12 -04:00
L Maffeo
7369933232 Updated documentation 2018-08-28 21:50:24 +02:00
Io Ii
10c40b1575 Second review by @sampsyo 2018-08-26 08:35:16 +02:00
Adrian Sampson
1f37cb61a3
Merge branch 'master' into master 2018-08-25 06:55:12 -07:00
L Maffeo
dfb5fe3276 Merged changes in changelog.rst 2018-08-18 16:17:14 +02:00
L Maffeo
b179df963a Minor rewording 2018-08-18 14:29:34 +02:00
L Maffeo
d4cecccdac Renamed plugin, added comments and minor fixes. 2018-08-18 14:22:25 +02:00
L Maffeo
fc1592adbe Renamed plugin, added default configuration and comments 2018-08-18 14:17:00 +02:00
Adrian Sampson
890ba85c79
Merge pull request #3004 from thetarkus/gmusic-additions-2
gmusic plugin fixes and additions
2018-08-15 12:03:13 -04:00
thetarkus
e824132137 Rename oauth_filepath to oauth_file, update gmusic doc 2018-08-15 11:42:04 -04:00
Adrian Sampson
cab6910866
Merge pull request #2718 from beetbox/fix-itunes
fetchart: Restore iTunes Store source
2018-08-15 10:34:07 -04:00
Adrian Sampson
c99bde4786
Fix a typo 2018-08-15 10:31:40 -04:00
nath@home
ff6306b663 Changelog for #2718
Reverts 49e548bd from #2540
Fixes #2371 #2551
2018-08-15 15:21:18 +02:00
thetarkus
971b0718c7 Update gmusic docs 2018-08-14 23:44:03 -04:00
Mike Mob
e13faf7f24
Update gmusic.rst 2018-08-13 22:25:36 -04:00
Mike Mob
2b031be99c
Update gmusic.rst 2018-08-13 19:16:01 -04:00
L Maffeo
67568b4f4c Passed tox tests 2018-08-12 19:37:31 +02:00
L Maffeo
5617eef6c7 Added subsonic plugin 2018-08-12 17:48:53 +02:00
Scott Carlson
136a77671d
Fixing gmusic docs 2018-08-04 22:42:45 -05:00
Scott Carlson
697a55e6e3
Adding auto parameter info
Adding auto parameter info to explain usage and functionality of importing all tracks to Google Play Music
2018-08-04 22:04:14 -05:00
Paul Sori
be48140846 add mstream to docs 2018-07-25 16:42:36 -04:00
Mike
1d32849daa Add ability for play plugin to emit utf8 BOM 2018-06-08 23:26:48 -06:00
Adrian Sampson
3ede5f26c8 Link to beets-barcode 2018-06-01 16:17:09 -04:00
Tobias Sauerwein
8768e786af Fix toctree. 2018-04-20 08:47:43 +02:00
Tobias Sauerwein
ad3b5b1d76 Fix target name. 2018-04-20 08:38:14 +02:00
Tobias Sauerwein
2ac0a00241 Fix short title underline. 2018-04-20 08:24:05 +02:00
cgtobi
7d45eabb25
Merge branch 'master' into sonos 2018-04-20 07:44:21 +02:00
Tobias Sauerwein
5e084b7186 Fix exception handling and add docs to the toc. 2018-04-20 07:39:12 +02:00
Tobias Sauerwein
dcce29eeb3 Add documentation for the sonos updater plugin. 2018-04-20 00:07:40 +02:00
Laurent Kislaire
feca2b9ffb Plugins doc update
Sort plugins within each section. Section "other plugins" kept as is.
2018-04-01 20:27:52 +02:00
Adrian Sampson
6d5a1e9284 web docs: Split CORS credentials paragraph (#2821) 2018-02-26 18:02:16 -05:00
Samuel Loury
e3599742b4 Add a support for supports_credentials
If the web plugin is behind a credential based http server and is
accessed by another in-browser client in another domain, the
specification of CORS requires the server to indicate it supports
such credentials.
2018-02-26 21:08:02 +01:00
Adrian Sampson
1254d48b72 Revise docs for #2739 2018-02-24 10:42:32 -05:00
wisp3rwind
db85c28c7f Advanced fetchart source config: documentation 2018-02-24 11:26:50 +01:00
wisp3rwind
dee2885457 docs/plugins/fetchart: fix internal link target location 2018-02-24 11:26:50 +01:00
Adrian Sampson
e7417e3683 lyrics: Don't crash when BeautifulSoup isn't found 2018-01-30 22:31:15 -05:00
Adrian Sampson
b47e3ec565 Fix lyrics docs: genius backend is default-enabled 2018-01-30 22:25:18 -05:00
Adrian Sampson
b28e0b43ff Merge pull request #2778 from ylep/replaygain-options
Add --force, --write and --nowrite options to replaygain plugin
2018-01-02 14:50:27 -05:00
Yann Leprince
d9bec61e98 Merge branch 'master' of https://github.com/beetbox/beets into replaygain-options 2018-01-02 12:35:27 +01:00
Yann Leprince
1b247dffff Document new options to the replaygain sub-command 2018-01-02 12:34:34 +01:00
Yann Leprince
079e167b6b Merge branch 'master' of https://github.com/beetbox/beets into fix-bs1170gain 2018-01-02 10:54:40 +01:00
Yann Leprince
8975234cd8 Add version requirement for bs1770gain to the documentation 2018-01-02 10:54:13 +01:00
translit
01573ce913
Word swap 2017-12-30 01:21:35 +01:00
Adrian Sampson
d932aa4f5c
Merge pull request #2750 from woparry/master
Add tags configuration to acousticbrainz plugin
2017-12-02 22:19:23 -05:00
Aaron Jubbal
e24f732014 Changed dont_convert to no_convert. 2017-11-29 20:08:50 -08:00
Aaron Jubbal
e5d782a3b1 Added docs for dont_convert option. 2017-11-29 16:41:27 -08:00
Owen Parry
325ae6f0ee Add tags configuration to acousticbrainz plugin 2017-11-27 07:55:38 -08:00
translit
abefae12a0
Update fetchart.rst 2017-11-01 08:06:30 +01:00
Adrian Sampson
75c668b7d9 Remove a needless warning from docs (#2708)
No need for caution anymore! 😱 With confirmation, we don't need
this warning.
2017-10-08 13:17:21 -04:00
konman2
fdeef05cc9 clearart asks for permission before deleting embedded albumart 2017-10-07 20:42:01 -07:00
Jonas Wagner
d7abf0b8e1 Update GStreamer installation instructions for Mac OS X. 2017-09-22 20:32:45 +02:00
David Logie
61b0246651 mbcollection: Add support from removing albums.
Add a new ``mbcollection.remove`` configuration option (default: None)
and a new ``-r`` (``--remove``) flag which removes albums from
collections that are no longer present in the beets database.

The ``-r`` flag takes precedence over the ``remove`` configuration
option.
2017-09-14 15:49:42 +01:00
David Logie
8eb233331c Update changelog/docs for new `mbcollection.collection` option. 2017-09-09 21:38:33 +01:00
euri10
25fb2453b4 Modified the name of the fetchart plugin switch from missing to quiet 2017-09-05 18:27:47 +02:00
euri10
b2fd274e2c Added a missing switch to the fetchart command so that only missing albums
are displayed
2017-09-05 16:34:26 +02:00
Adrian Sampson
2b31b493a6 Refine docs for #2663 2017-08-21 14:29:34 -04:00
Tigran Kostandyan
bfdcbe2aac Update gmusic.rst 2017-08-21 11:38:11 +03:00
Adrian Sampson
598c965b0f Simplify text for #2653 2017-08-11 14:35:22 -04:00
plittlefield
9e2a71eec3 Update zero.rst 2017-08-11 16:12:29 +01:00
Adrian Sampson
d44eda56c5 Docs refinements for lyrics ReST output 2017-07-16 10:07:32 -04:00
Adrian Sampson
c655a13c41 Use title case in docs 2017-07-16 10:02:14 -04:00
Antoine Beaupré
f667428758
write sphinx base files
we write the artists files in a subdirectory, to avoid infinite
recursions or flooding the current directory needlessly.

this way, the user has a good base structure and can just chain the
command into sphinx to continue building the next format, after
possible tweaks.
2017-07-15 15:43:16 -04:00
Antoine Beaupré
d330353e1c
rename the skip option to local
skip was a misnomer: we actually skip "unfetched" lyrics. this means
it's somewhat of a double-negative and really confusing.

--local is clearer, although less in opposition with --force
2017-07-15 14:19:25 -04:00
Antoine Beaupré
32de4148bc
use glob patterns correctly in index 2017-07-15 09:30:14 -04:00
Antoine Beaupré
63aa3b3165
write to separate rst files
this makes the ePUB easier to parse by e-readers, because they do not
need to load one giant HTML file, but one per author. it also makes
sphinx rendering more efficient and interactive
2017-07-15 09:23:58 -04:00
Antoine Beaupré
2fa46a7507
add documentation for new lyrics flags 2017-07-14 17:43:37 -04:00
Adrian Sampson
1f2b8cef97 Tiny code and docs fixes for gmusic (#2586) 2017-06-14 19:05:38 -04:00
Adrian Sampson
4563e3b6dd Merge pull request #2586 from tigranl/gmusic
Add Google Music plugin
2017-06-14 18:52:20 -04:00
Tigran Kostandyan
2d7962c552 Update toctree 2017-06-13 02:48:43 +03:00
Tigran Kostandyan
8555481482 Update index.rst 2017-06-13 01:41:06 +03:00
Tigran Kostandyan
28ba733ebe Add custom exception and mark fields as redacted.
Remove Musicmanager global variable.
Update gmusic.rst
2017-06-11 22:27:44 +03:00
Adrian Sampson
f6dc981217 Edit docs from #2576 for brevity
Fixes #1741.
2017-06-10 20:42:18 -04:00
Adrian Sampson
61fa3ee272 Merge pull request #2576 from smlx/gapless-mp3
Document gapless mp3 encoding.
2017-06-10 20:37:10 -04:00
tigranl
b1d8321e40 Add Google Music plugin 2017-06-05 16:48:23 +03:00
Scott Leggett
348e04464a Remove absolute paths from sample script. 2017-05-26 07:26:07 +10:00
Scott Leggett
a93414dc9d Document gapless mp3 encoding. 2017-05-25 22:53:22 +10:00
Michal Koutenský
8168a88a7f update replaygain docs with info about r128 2017-05-17 21:58:41 +02:00
Shen-Ta Hsieh(BestSteve)
09ea5448f1 Recompress png file (#2552)
Signed-off-by: Shen-Ta Hsieh <ibmibmibm.tw@gmail.com>
2017-05-05 19:52:55 +01:00
Fabrice Laporte
409f070970 Remove lyrics.com source 2017-05-03 22:54:09 +02:00