Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2025-12-07 00:53:08 +01:00
Code Issues Projects Releases Wiki Activity
12222 commits 43 branches 64 tags 60 MiB
Commit graph

419 commits

Author SHA1 Message Date
Stig Inge Lea Bjørnsen
58924375d3 Merge pull request #521 from silb/datequery_plugin 
Add a plugin for querying date fields against date intervals or instants...
 2014-02-04 13:03:39 -08:00
Stig Inge Lea Bjørnsen
732daddf53 Move the date query documentation into the query reference documentation. 2014-02-04 21:48:33 +01:00
Adrian Sampson
aaeb166608 a bit more documentation for --config 2014-02-02 13:48:21 -08:00
Adrian Sampson
8b87fff3e3 a bit more documentation for --group-albums (#518) 2014-02-01 12:52:16 -08:00
Thomas Scholtes
d75f6667e1 Add --config cli option 2014-01-29 23:38:05 +01:00
Thomas Scholtes
a4b6976755 Make plugin path configuration useable 2014-01-20 17:39:46 +01:00
Adrian Sampson
f239489549 docs: remove outdated path_format config option 
The example config contained a configuration key that's been unsupported for
years! How embarrassing.
 2014-01-10 19:12:45 -08:00
Adrian Sampson
f98dde1b7e docs/changelog for write (#328, #448) 2013-11-25 15:34:11 -08:00
Adrian Sampson
c0c01b2680 id3v23 config option (fix #388) 2013-10-06 20:20:18 -07:00
Adrian Sampson
ddf5c4ce54 integrate FAQ links with the rest of the docs 2013-09-16 19:26:09 -07:00
Adrian Sampson
4f1ce5a64c docs: mention musicbrainz port config (closes #365) 2013-09-12 11:11:04 -07:00
Adrian Sampson
bb191e7ced Merge pull request #354 from mineo/docs-fixup-2 
Docs fixup
 2013-08-06 09:46:14 -07:00
Wieland Hoffmann
39d67363b5 ref/cli.rst: Remove a 'd' 2013-08-06 10:40:17 +02:00
Wieland Hoffmann
e0ea009508 ref/cli.rst: Add a missing 'k' 2013-08-06 10:40:17 +02:00
Wieland Hoffmann
0082570e11 pathformat.rst: Add back "track" 
This got lost in e0bb3b5cd0 but is really essential enough to appear in that list.
 2013-08-03 15:13:29 +02:00
Wieland Hoffmann
cc3d12f218 docs/.../cli.rst: Add an of to the description of update -p 
This seems to have been missed when the documentation was added in the first place.
 2013-07-12 19:11:47 +02:00
Adrian Sampson
58bd8a9e24 docs: a note about albums and the update command 2013-06-15 22:49:14 -07:00
Adrian Sampson
b1ea90a724 don't duplicate penalty names in max_rec section 
This is for maintanability: in the future, when we add new distance penalty
components, now we won't have to list them twice in the default config.
 2013-06-10 15:59:41 -07:00
Adrian Sampson
82991ce614 documentation enhancements for new config opts 2013-06-10 15:53:06 -07:00
Tai Lee
f3545860da Add ignored setting. Don't show matches with specified penalties applied, e.g. missing tracks or unmatched tracks. 
If you know you never want these, they can clutter up the interface
especially now that we have multiple data sources.
 2013-06-03 00:35:32 +10:00
Tai Lee
45dc99f1a9 Group preferred media patterns, in case they contain "|" to keep them separate from the number of media. 2013-06-03 00:25:31 +10:00
Tai Lee
e6ac8e1646 Use a Distance object instead of floats for distance calculations. 
The new Distance object knows how to perform various types of distance
calculations (expression, equality, number, priority, string).

It will keep track of each individual penalty that has been applied so
that we can utilise that information in the UI and when making decisions
about the recommendation level.

We now display the top 3 penalties (sorted by weight) on the release
list (and "..." if there are more than 3), and we display all penalties
on the album info line and track change line.

The implementation of the `max_rec` setting has been simplified by
removing duplicate validation and instead looking at the penalties that
have been applied to a distance. As a result, we can now configure a
maximum recommendation for any penalty that might be applied.

We have a few new checks when calculating album distance:

`match: preferred: countries` and `match: preferred: media` can each be
set to a list of countries and media in order of your preference. These
are empty by default. A value that matches the first item will have no
penalty, and a value that doesn't match any item will have an unweighted
penalty of 1.0.

If `match: preferred: original_year` is set to "yes", beets will apply
an unweighted penalty of 1.0 for each year of difference between the
release year and the original year.

We now configure individual weights for `mediums` (disctotal), `label`,
`catalognum`, `country` and `albumdisambig` instead of a single generic
`minor` weight. This gives more control, but more importantly separates
and names the applied penalties so that the UI can convey exactly which
fields have contributed to the overall distance penalty.

Likewise, `missing tracks` and `unmatched tracks` are penalised and
displayed in the UI separately, instead of a combined `partial` penalty.

Display non-MusicBrainz source in the disambiguation string, and
"source" in the list of penalties if a release is penalised for being
a non-MusicBrainz.
 2013-06-02 18:25:10 +10:00
Adrian Sampson
b3646f2659 fix some docs syntax 2013-05-28 21:28:26 -07:00
Tai Lee
a5151bb32e Look at many more metadata fields when calculating distance. 
Produce slightly more varied similarity score to prioritise extremely
similar releases.
 2013-05-29 10:18:55 +10:00
Tai Lee
e66a865f17 Rename the discogs max rec setting to non_mb_source, so it can apply to all data source plugins. 2013-05-25 22:44:41 +10:00
Tai Lee
f5557a74d7 Update intersecting max_rec and discogs docs. 2013-05-24 15:01:19 +10:00
Adrian Sampson
45baa6efe1 first stab at "advanced guide" 2013-05-19 17:35:23 -07:00
Adrian Sampson
0bb51e9f1b thanks and doc tweaks for duplicates (#278) 2013-05-17 12:20:27 -07:00
Adrian Sampson
916ceb4b15 changelog and tweaks for #275 
I've removed the -p option. The command now always shows plugin-provided
template fields if any are available. We also avoid printing out blank lines
for plugins that don't provide fields.
 2013-05-17 11:55:17 -07:00
Pedro Silva
4f5faeccac Append plugin template fields to 'beet fields' output with -p, --plugins 2013-05-15 13:41:54 +01:00
Adrian Sampson
056cf932d8 docs/changelog for date added (#264) 2013-05-11 13:31:42 -07:00
Lucas Duailibe
5c31d3ac15 Formatting the import time in the view and paths 
Added the %format{} template function to output the time to any format supported by time.strftime()
 2013-05-11 10:53:43 -03:00
Adrian Sampson
cc13edf49f changelog/docs for range queries #261 2013-05-09 16:13:22 -07:00
Adrian Sampson
e920cacfed fix link to MusicBrainz albumtype docs 2013-04-25 09:19:33 -07:00
single-sandwiches
563c4be2ad Update pathformat.rst 
Fixed link pointing to the MusicBrainz wiki in regards to the list of albumtype: type names
 2013-03-11 22:46:26 +11:00
Adrian Sampson
5f3ebde6bb mbsync: docs/changelog 
As discussed on #115, this has the "reimport" docs refer to the mbsync plugin.
 2013-03-03 16:41:48 -08:00
Adrian Sampson
f268aae17f add --flat option to import command (GC-202) 2013-02-26 20:59:52 -08:00
Adrian Sampson
706c4fb7f6 import.detail config option (GC-263) 2013-02-26 20:36:29 -08:00
Adrian Sampson
0045880f58 change option name to "languages"; docs (#102) 2013-02-26 14:38:34 -08:00
Adrian Sampson
fa9d326d39 ignore "System Volume Information" directory 
This is a control directory on Windows whose permissions are always set very
restrictively:
http://blogs.msdn.com/b/oldnewthing/archive/2003/11/20/55764.aspx
 2013-02-24 15:53:47 -08:00
Adrian Sampson
3e624ea884 original_date config option (GC-441) 2013-02-08 13:45:31 -08:00
Adrian Sampson
e0bb3b5cd0 original_{year,month,day,date} fields (GC-441) 2013-02-08 13:28:51 -08:00
Adrian Sampson
15a652ab73 docs/changelog: filename length detection (GC-461) 2013-02-08 12:57:31 -08:00
Adrian Sampson
fa4d8d96e7 max_rec (#98): more lenient defaults 
These defaults more closely reflect the current behavior of beets, which I
think is desirable.
 2013-02-07 23:39:13 -08:00
Adrian Sampson
7a4c228c79 style tweaks & doc expansion (#98) 2013-02-07 23:35:27 -08:00
Tai Lee
baa5bc5a01 Add max_rec configuration options. 
Allow users to apply a maximum recommendation to partial albums and albums
with differing track lengths/numbers.
 2013-02-08 17:42:00 +11:00
Adrian Sampson
d544c832c7 changelog, docs, and style tweaks for #93 2013-02-04 22:44:04 -08:00
Adrian Sampson
2ea190ceba better error message when using real tabs 2013-02-02 10:37:02 -08:00
Adrian Sampson
bba0051ee7 changelog & doc tweaks for smartplaylist (#80) 2013-01-31 10:07:18 -08:00
Adrian Sampson
521a4d1ebd Merge pull request #77 from mrmachine/none-rec-action 
For matches with no recommendation, import as-is or skip automatically.
 2013-01-30 20:38:12 -08:00
Adrian Sampson
ee641e9b13 default_action config option, et cetera (#76) 
- Partial matches are always downgraded to a "medium" match.
- The config option, now called "default_action", lets you choose what to do
  with "medium" matches.
- Expanded the "low" recommendation level to include cases with just one
  match.
 2013-01-30 20:32:37 -08:00
Tai Lee
6286954435 Add docs for confirm_partial setting. 2013-01-29 15:04:01 +11:00
Tai Lee
1d236aaa79 Add docs for none_rec_action setting. 2013-01-29 15:02:32 +11:00
Adrian Sampson
cc0e9112b4 document migration from 1.0 to 1.1 2013-01-24 16:55:00 -08:00
Adrian Sampson
9e6b1db02d configurable match thresholds (GC-290) 2013-01-11 14:46:15 -08:00
Adrian Sampson
c418e6d379 configurable MusicBrainz host/rate limit (GC-408) 2013-01-11 13:33:14 -08:00
Adrian Sampson
974929541f terminal_encoding config option (GC-472) 2013-01-11 13:07:57 -08:00
Adrian Sampson
b9a6f4d617 remove outdated "art" config in docs 2013-01-06 16:21:20 -08:00
Adrian Sampson
3e2aca82b8 correctly parse and migrate "pluginpath" 
This used to be a colon-separated list. Now we use a real YAML list (or a
single string).
 2012-12-31 16:09:16 -08:00
Adrian Sampson
11e1fd1bd8 document new Confit-based configuration 2012-12-20 21:56:47 -08:00
Adrian Sampson
128a881bb4 GH-69/GC-450: docs, changelog, simplification 2012-12-05 09:10:07 -08:00
Adrian Sampson
3952fbec62 docs & changelog for pervasive format config (#62) 
This version of the (renamed) _print_obj function uses introspection to
determine whether we're printing an Album or an Item. It's like function
overloading for Python! 😁
 2012-10-20 20:29:49 -07:00
Adrian Sampson
244ffd71e2 fix "beet modify" for date fields (GC-449) 
This is fixed by allowing MediaFiles to convert strings to integers on
assignment. An eventual complete fix will perform these type conversions in the
Item interface.
 2012-10-14 20:27:13 -07:00
Adrian Sampson
cb93900888 changelog & docs for "beet stats --exact" 2012-10-07 15:13:49 -07:00
Adrian Sampson
1372e42dec docs: warn that incremental must be enabled early 2012-09-30 14:16:30 -07:00
Adrian Sampson
8a63a381b4 docs: for per_disc_numbering, change path formats 2012-08-03 17:37:14 -07:00
Adrian Sampson
1f5ae6600b warning when using unrecognized fields in queries 2012-07-25 15:41:22 -07:00
Adrian Sampson
11d4fb1abb move album art fetching to a plugin (fetchart) 2012-06-24 00:34:50 -07:00
Petr Viktorin
d3c8297527 Add missing parenthesis in docs 2012-06-17 20:26:26 +03:00
Adrian Sampson
b3e0724676 send prompts to stdout (GC-389) 2012-05-20 11:42:53 -07:00
Adrian Sampson
711a1c1113 apply artist credits & add to database (GC-286) 2012-05-19 16:13:15 -07:00
Adrian Sampson
2b000c47a2 per_disc_numbering config option (GC-335) 2012-05-17 12:44:48 -07:00
Adrian Sampson
c1d28252be use section headings for config options 
Previously, we were using a definition list. This way things are easier to link
to. It will also likely scale better as we add more config options.
 2012-05-16 17:37:38 -07:00
Adrian Sampson
9979c5a826 separate config options for item and album formats 
Extends GC-362 (GH-38) to use two different config options: one for albums and
one for items.
 2012-05-16 17:01:14 -07:00
Fabrice Laporte
42c51294d6 Merge pull request #38 from KraYmer/master 
Issue 362: Make the default template string for the list command configurable
 2012-05-16 15:59:22 -07:00
kraymer
81fc626ba7 Issue 362:Make the default template string for the list command configurable. 2012-05-17 00:48:55 +02:00
Fabrice Laporte
16d9b53168 Update docs/reference/cli.rst: add -f option to beet list command 2012-05-13 23:52:27 +03:00
Adrian Sampson
1baf49b333 fix still more documentation typos 2012-05-03 17:43:58 -07:00
Adrian Sampson
a2c12dc78f -c CLI option overrides import_move config option 2012-05-03 17:19:28 -07:00
Adrian Sampson
104aec3c2f cleanup and docs for regular expression queries 2012-05-01 20:03:01 -07:00
Adrian Sampson
c4f9b452da docs for %aunique (#190) 2012-04-29 14:52:03 -07:00
Adrian Sampson
e017a95154 docs: clarify single-quote comment is for Unix 2012-04-19 10:24:30 -07:00
Adrian Sampson
a64dea25b2 docs for @djrtl's changes (#30) 2012-04-15 14:24:52 -07:00
Adrian Sampson
7b7658fc43 doc clarification: effect of moving 2012-04-10 13:52:32 -07:00
Adrian Sampson
6b696c842f cleanup and docs for import_move (GH-26, GC-266) 
- Copying and moving are mutually exclusive. Moving overrides copying so the
  user only has to add one line ("import_move: true") to disable copying and
  enable moving in its place.
- Deleting is only possible when copying.
- Deprecating the "delete" option (moving is almost always better).
- Removed command-line switch for moving. It's somewhat "unsafe", so this
  removes some potential for accidental irreversible changes.
- Changelog & thanks.
- Update docs to refer to import_move instead of import_delete as the
  correct solution for ending up with only one copy of the file.
 2012-04-10 13:41:24 -07:00
Domen Kožar
1af4f86c17 support move action when importing 2012-04-05 01:14:17 +02:00
Adrian Sampson
251026b759 add a new batch of metadata fields 
The new fields are:
ALBUM: mb_releasegroupid asin catalognum script language country albumstatus
media albumdisambig
TRACK: disctitle encoder
These are not yet parsed from MusicBrainz responses (just added to MediaFile
and the database).
 2012-04-04 00:52:57 -07:00
Adrian Sampson
ffa2402ff4 revamp default character substitutions 
There's no longer a distinction between Unix and Windows substitutions. Enough
users reported problems with Windows-forbidden characters on Samba shares that
it seems appropriate to make all filenames Windows-safe, even on Unix. Users who
really want those additional characters (<>:"?*|\) can re-enable them via the
"replace" option. Nobody has complained about beets being *too* conservative.

This also adds sanitization of control characters, which is an all-around good
idea, and the substitution now runs in the Unicode (rather than byte) domain.
 2012-04-03 14:22:38 -07:00
Adrian Sampson
de6530f4a5 acoustid ID and fingerprint stored/tracked (#332) 2012-04-01 18:22:42 -07:00
Adrian Sampson
2f1ac61d4f track and album artist sort names (GH-25, GC-77) 
Previously, there was just an "artist sort name" field -- now there's a
corresponding sort name for both track artists and album artists. I also made
the names shorter (artist_sort and albumartist_sort).
 2012-03-25 17:02:52 -07:00
Adrian Sampson
c0c80cd576 docs typo: missing $ in path formats 2012-03-17 12:28:27 -07:00
Adrian Sampson
1b1b8c4ae3 cleanup/docs for list formatting (#203; #22 on GH) 2012-03-14 14:51:13 -07:00
Adrian Sampson
62cf26806c strip characters in replacement 2012-02-19 12:19:55 -08:00
Adrian Sampson
f4dc13161c document space replacement in .beetsconfig 2012-01-30 14:06:16 -08:00
Adrian Sampson
2ff4fe5ccd remove erroneous reference to -d flag (#314) 2012-01-29 13:44:06 -08:00
Adrian Sampson
fe33926038 add new audio properties to library/DB 
$samplerate now expands to "##kHz" in path formats.
 2012-01-27 16:04:51 -08:00
Adrian Sampson
307560a6c9 ignore all .* files by default (#293) 2012-01-16 17:09:25 -08:00
Adrian Sampson
6a082234fb docs fixes regarding album types 2012-01-11 17:10:26 -08:00
Adrian Sampson
ca6df97ee9 explain shorthand query keys 2011-12-28 19:06:15 -08:00
Adrian Sampson
d73c133a53 query-conditioned path formats (#210) 
Also, Library.path_formats is now a list of pairs instead of a dictionary. (I
would have used an OrderedDict, but that was added in 2.7.)
 2011-12-28 19:01:13 -08:00
Adrian Sampson
8fde981b1d add asciify function 2011-12-19 19:41:09 -08:00
Adrian Sampson
b493bc7004 configurable pathname substitution (#115) 2011-12-19 18:37:35 -08:00
Adrian Sampson
7a189b2135 document global CLI flags 2011-12-17 22:00:33 -08:00
Adrian Sampson
69c0e8d496 doc fixes for extensible template fields 2011-12-17 21:46:09 -08:00
Adrian Sampson
621b3d4bb7 link to plugin template format docs 2011-12-16 12:18:44 -08:00
Adrian Sampson
dd4ee6b2e4 document some template syntax details 2011-12-16 11:20:33 -08:00
Adrian Sampson
69845f2b24 documentation for function calls (#231) 2011-12-15 18:42:25 -08:00
Adrian Sampson
3c99e54174 switch out string.Template with new template parser (#231) 2011-12-15 11:53:58 -08:00
Adrian Sampson
0252865f61 fix some discussion of path formatting 2011-12-15 11:49:22 -08:00
Adrian Sampson
8736d359c6 "timeout" config value (#261) 2011-12-04 18:46:35 -08:00
Adrian Sampson
1ba4d74a75 use better default paths on Windows (#241) 2011-11-27 23:33:11 -08:00
Adrian Sampson
70c0a90793 manpage-ify the reference docs (#258) 2011-11-23 23:43:51 -08:00
Adrian Sampson
5965b37f51 skip (configurable) clutter filenames when importing 2011-11-13 17:14:40 -08:00
Adrian Sampson
4b5c674d9b "--pretend" (dry run) flag for update 2011-09-18 16:18:19 -07:00
Adrian Sampson
e013745f1c introductory paragraphs 2011-09-17 16:02:06 -07:00
Adrian Sampson
521131bc2b screenshot image and syntax cleanup 2011-09-17 15:32:27 -07:00
Adrian Sampson
4e6798b2a6 convert getting started guide 
--HG--
rename : docs/starting/index.rst => docs/guides/index.rst
rename : docs/starting/main.rst => docs/guides/main.rst
rename : docs/starting/tagger.rst => docs/guides/tagger.rst
 2011-09-16 17:40:22 -07:00
Adrian Sampson
737eabdb8c translate reference pages from wiki 2011-09-16 17:08:10 -07:00
Adrian Sampson
18aff4db01 Sphinx documentation skeleton 2011-09-16 13:57:15 -07:00